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A SERIOUS MATTER 


At the foot of this page you will find an apology to Beebug 
Ltd. from Argus Specialist Press, publishers of Archimedes 
World. This relates to an item published as part of 
Archimedes World last year which contained a totally 
unwarranted and unjustified attack on the reputation of 
Beebug as a company and organisation operating in the 
Acom market. That this should have happened without the 
knowledge of the publishers in no way mitigates the 
damage that might be caused, and only confirms the need 
for all publishers to be careful and responsible with regard 
to all the material which they publish. 


Magazine discs, for example, whether cover-mounted or an 
optional extra, need careful checking, something that we 
undertake as a matter of course. It is a matter of some 
concern to us that other magazines do not feel that such 
efforts are worthwhile. The consequences can be disastrous 
for Archimedes users - for example, the Archimedes World 
cover disc for February 1992 contains a virus which is readily 
detectable with a utility available to software developers 
from Acom. 


In general, the Acorn world is remarkable for the degree 
of goodwill and co-operation which exists between 
otherwise competing organisations (magazine publishers, 
software houses, dealers etc.). Beebug Ltd. and RISC 
Developments Ltd. would like to continue their good 
relationships with all companies within the Acorn 
marketplace, but would like to make it clear that legal 
action will be taken if the reputation or interests of either 
company is unfairly or improperly threatened. 


COPYRIGHT 


This is not the first time in recent months that action has 
been needed to protect our interests. Early last year a 
magazine included a RISC User program on its magazine 
disc without our authorisation, and two further examples 
of this came to light during 1991. We also found a 
number of public domain libraries illegally distributing 
programs where the copyright belongs to RISC 
Developments Ltd. and our solicitors were again asked to 
take action on our behalf. 


All programs from whatever source, including those 
published by magazines like RISC User, are subject to 
copyright. No program may be copied or distributed 
without the express permission of the copyright holder. To 
do otherwise is against the law, and hurts the majority of 
law abiding users who find themselves paying a higher 
price for a product than might otherwise have been the 
case. 


We would also draw readers’ attention to the Federation 
Against Software Theft (FAST). Through education and 
publicity, and by collecting evidence for the prosecution of 
offenders under the law, FAST aims to combat software 
piracy. It has our full support in such endeavours. 


We will take action, as we have already done, against 
anyone whom we reasonably believe to be illegally 
distributing software of any kind. Indeed, we would ask all 
our readers to be vigilant and to inform us (or other 
software publishers) if they find evidence of the 
unauthorised distribution of software, Our thanks, too, to 
those who have already helped us in this way. Remember 
that the unauthorised use or distribution of software is 
theft. M.W 


FROM THE PUBLISHERS OF 
ARCHIMEDES WORLD 


The following statement appeared in the February issue 
of Archimedes World and is reproduced here with the 
agreement of the publishers of that magazine. 


The publishers of Archimedes World regret an attack on 
the reputation of Beebug which was contained in an 
item accompanying a recent issue of Archimedes World. 


The publishers entirely disassociate themselves from this 
remark and apologise unreservedly to Beebug for having 
published this unjustifiable slur on their activities as a 
reputable company serving Archimedes users. 


The publishers of Archimedes World have agreed to pay 
a sum by way of agreed damages to Beebug to seek to 
compensate them for the slur on their reputation. 
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SOFTWARE FOR ECONET 
BULLETIN BOARDS 


Schools and colleges with Acorn 
Econet networks may find the latest 
software from XOB of interest. 
Bulletin \s an application which runs 
on any Archimedes connected to an 
Econet network. It allows users to 
read messages left by other users 
and to reply to them, Different 
bulletin boards (up to 20) may be set 
up covering different topics, and 
access can be controlled In the form 
of closed user groups. XOB claim 
that such a scheme Is Ideal for 
tutorial work and the development 
of ideas. 


The software, written in C, is fully 
RISC OS compliant and costs £67.00 
for a site/network licence from XOB, 
Balkeerle, Eassie, Angus DD8 1SR, 
tel. (030784) 364, 


FREDDY TEDDY VISITS 
THE PLAYGROUND 


Topologika’s series Freddy Teddy 
continues to expand with the release 
of The Playground, in which our 
eponymous hero visits a playground 
waiting for children to tell him what 
to do. Bulit-in sound effects include 
digitised speech, and Freddy's 
infectious giggle when you get 
something right. The Playground costs 
£29.95 (ex. VAT) from Topologika, 
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PC CARD FROM ALEPH ONE 


Even though Acorn has neglected a hardware PC emulator, 
innovator Aleph One has not, and has announced a 386 PC 
Expansion Card for the Archimedes. Aleph One claims that its card in 
an Archimedes produces a ‘real’ PC on the Desktop running 12 
times faster than the software emulator. The card uses a 20 MHz 
386SX processor chip and optional 387 maths co-processor, together 
with up to 4 MB of dedicated RAM. The PC Expansion Card has 
serial and parallel ports allowing the direct connection of peripheral 
devices. The card is expected to be available from the beginning of 
March, and will cost £595 for a 1 MB version, and £725 for a 4MB 
version (ex. VAT). For more information on what sounds to be an 
exciting and significant product for the Archimedes, contact Aleph 
One at The Old Courthouse, High Street, Bottisham, Cambridge CB5 
9BA, tel. (0223) 811679. 


FONTS FANTASIA 


EFF, the Electronic Font Foundry, which has established itself in the 
vanguard of suppliers of outline fonts, continues to expand its 
catalogue. Latest fonts to be released include Allegro and Adante 
(two flowing scripts), Eric 1 (sans serif), Eve Open, Franca, Aidan, 
Mr Jones and Shel (more fancy fonts), Cartograph (mapping 
symbols) and Symphony (music notation) among others. Some of 
these are replicas of existing fonts; some are completely new 


designs. 
PostScipt™ compatible type faces 
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New EFF designed typefaces 
akian REGULAR 
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Shel Regular italic 


For further infor- 
mation contact EFF at Granville House, 50-52 Upper Village Road, 
Ascot SL5 7AQ, tel. (0344) 28698, fax (0344) 872923. 


ACORN’S GUIDE TO GOOD ENGLISH 


Acorn Computers Ltd. has now made available a previous 
internal guide to the writing of technical manuals. The Acorn 
Technical Publications Style Guide is aimed at writers of technical 
manuals for the Archimedes. Topics covered range from general 
English usage (spelling and punctuation), through typographical 
conventions, a useful section on trademarks and technical terms, 
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to general guidance on manual layout and organisation. While 
consistency throughout the Acorn world on technical terms and 
abbreviations is 
clearly beneficial, not 
everyone will agree 
with English spelling 
as defined by Acorn 
(coordinate rather 
than co-ordinate, for 
example). However, 
this guide was written 
entirely for the benefit 
of Acorn’s own 
technical authors, so 
they can be forgiven a 
few idiosyncrasies. 
The guide costs £9.95 
and should be 
available through 
Acorn dealers (it is 
available from Beebug 
Ltd.). 


Acorn Technical Publications 
Style Guide 


So 


Avorn @ 


LONGMAN LOGOTRON UNVEILS 1992 PLANS 


Educational software house Longman Logotron has revealed plans 
for new software releases in 1992. A new development, available 
now, is Insight, a datalogging package designed at Leicester 
University with support from NCET. It comprises two 
applications, Analogue and Digital, for measuring both continuous 
and discrete data. 
The software will 
work with most 
popular interfaces 
such as Sense and 
Control, SenselT, 
LogIT and Philip 
Harris and pro- 
vides a_ wide 
range of features 
for the analysis 
and display of 
data captured. 
The price of this is 
£69.00 (all 
Longman Logotron prices are quoted ex. VAT). 


Junior Pinpoint, due for publication at the end of February, is a 
simplified version of the already successful Pinpoint package (see 
review in RISC User Volume 5 Issue 3) targeted specifically at the 
needs of primary schools, and with a price tag of just £24.00. The 
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P.O.Box 39, Stilton, Peterborough PE7 
3RL, tel./fax (0733) 244682. 


ALL FORMAT FAIRS 


Latest dates and venues for All 
Formats Computer Fairs are as 
follows: 
Feb 23 National Motorcycle Museum, 
near NEC, Birmingham. 
Mar 8 City Hall, Candleriggs, Glasgow. 
Mar 14 Horticultural Hall, Westminster. 
Mar 15 Brunel Centre, Temple Meads, 


Bristol. 
Mar 21 Donnington Park, East Midlands. 
Mar 22 Unlversity Sports Centre, 
Calverley Street, Leeds. 
For information and tickets contact 
John Riding on (0225) 868100. 


WORTH A DETOUR 

Detour Is the name of a file 
manipulation utility from software 
and electronics design specialists, 
Electronic Solutions. Detour 
intercepts all read and write file calls 
within the RISC OS Filer, and then 
processes them as determined in 
advance by the user. This covers 
control of file access for protection 
and logging (including virus 
protection), and device redirection 
(so that software designed to run 
from floppy can equally be run from 
SCSI or any other source device). 
Detour costs £19.95 Inclusive direct 
from Electronic Solutions, Ceralyn, 
Maindy Croft, Ton-Pentra, Mid 
Glamorgan CF41 7ET, tel. (0443) 
430355. 


ETHERNET 

CONNECTIVITY 

Atomwide, Archimedes hardware 
specialist, has announced a low cost 
Ethernet card for the Archimedes 
range of The card allows 
users of Acorn's UNIX operating 
system RISCIX to attach workstations 
and terminals using the TCP/IP 
protocols, RISC OS users must first 
purchase a copy (or site licence) of 
Acorn's TCP/IP protocols separately, 
and will still require at least one 
Archimedes based UNIX system to 
act as file server. 
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Auto logon number directory 


Fully RISC OS compliant 

+ Multi-tasking, including background file transfers 

+ T1320, VT102, VT52, ANSI and Teletype scrolling text 
terminals 

¢ Viewdata and Minitel (CEPT 2) terminals 

« Viewdata editor, telesoftware downloading and frame 
tagging 

« Advanced Tektronix 4105 colour graphics terminal using 
Draw file format 

* Scalable terminal windows in all screen modes 

+ Xmodem, Xmodem1K, Ymodem, Zmodem, Kermit, 
SEAlink and ASCII file transfer protocols, including batch 
transfers 

* Campus 2000 terminal 

* Comprehensive script language based on a subset of C 

+ User menu may be customised for special applications 

* Macro processor and fully definable keyboard 

+ Support for RISC OS printer drivers 

+ Number directory with auto logon and password protection 

« MNP 2 and Vasscom link level error correction 

+ Modem drivers for most popular modems. Additional drivers 
may be written in the script language and added to the 
system 

+ Facility to automatically record logon procedures 

+ Supplied with a 200-page ring-bound user guide 


Price: £75 + VAT 


Upgrade from version 1 includes new package, user guide and discs. 
To upgrade, please return your original disc to the address below. 
Price: £35 + VAT + £3.10 p&p. Total: £44.22 


ISC 


Samm 25 
‘developments 


RISC Developments Ltd. 
117 Hatfield Road, St. Albans, Herts. AL1 4JS 
Tel: (0727) 40303 Fax: (0727) 860263 
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established educational word processor, PenDown, is to have a new 
enhanced version to be called PenDown Plus. This will be aimed at 
older age groups and will include new mail merge and table editor 
facilities, together with enhancements to existing features. This is 
scheduled for release in May at a price of £79.00. 
. 

Finally, the long awaited Eureka spreadsheet application, at a price of 
£119.00, should also be available round about May time - we will 
certainly be reviewing this as soon as we can obtain a copy. For more 
information, and a copy of its latest catalogue, contact Longman 
Logotron at 124 Cambridge Science Park, Milton Road, Cambridge 
CB4 4ZS, tel. (0223) 425558, fax (0223) 425349. 


MEGA-LEISURE 


The authors of flight simulators Interdictor (published by Clares), and 
Mig-29 (published by Domark) have now entered the leisure market 
in their own right with the release of the Flight Simulator Toolkit. This 
enables you to create your own design of aircraft and the world over 
which you fly, and to determine your own targets. The software is 
structured around a ground editor, 3D shape editor, aircraft model 
editor and cockpit editor all linked by a simulation framework. The 
package comes complete with a library of predefined shapes and 
aircraft (from Cessna to Tornado) and costs £45.00 inc. VAT. Flight 
Sim Toolkit is available from dealers, or direct from Simis Ltd., 26 
Chitty’s Walk, Guildford, Surrey GU3 3HW, tel. (0483) 233048, fax 
(0483) 235275. 


ESM EXPANDS ON DESKTOP FOLIO 


ESM, publisher of Desktop Folio, has been busy expanding the range 
of supporting packs which now include an Editor's Pack and a Maths 
Pack. Each of these theme 
packs costs £29.50 ex. VAT. 
ESM is also adding a variety 
of font packs to complement 
Desktop Folio, including 
Script Font Pack (at £45.00) 
and Decorative Font Pack (at 
£37.00), both based on EFF 
fonts. 


Other releases include an 
Archimedes version of World 
Map Study, updated from the 
previous BBC geography pack, and Bookstore, a database program 
which encourages children to record and retrieve book reviews 
which they have written. World Map Study costs £42.50 and 
Bookstore costs £39.50 (both ex. VAT). 


For more information, and a copy of ESM’s latest catalogue, write to 
ESM, Duke Street, Wisbech, Cambs, tel. (0945) 63441. 
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Cards are available at £229 ex. VAT 
for the A3000 and A300/400/500 
series (all internally fitted). For more 
information contact Atomwide, 23 The 
Greenway, Orpington, Kent BRS 2AY, 
tel. (0689) 838852, fax (0689) 896088. 


FIRST AND SECOND 
IMPRESSIONS 

Two new guides to help those using 
Computer Concepts’ Impression are 
now available from Word Processing 
of Wolverhampton. The first package, 
released last year, Is First 

a tutorlal guide for new users of 
Impression DTP. It consists of a 
substantial ring binder supplied in a 
standard CC Impression slip box, 
together with two discs of examples 
referred to within the tutorial. The 
guide Is fully approved by CC, and 
should prove a useful adjunct to the 
standard Impression manual. First 
Impressions costs £29.95 direct from 
the publisher. 


First seen at the BETT show, Word 

has also produced Good 
Impression, aimed at more 
experienced users of Impression. This 
comprises 220 wiro-bound pages, 
and is accompanied by three discs. 
This is much more a guide to good 
typographic layout and practice, and 


therein. Good Impression costs 
£26.95 (we hope to review both 
guides In the next issue of RISC User). 


The guides may be obtained from 
Word Processing, 65 Milkdale Crescent, 
Fordhouses, Wolverhampton, West 
Midlands WV10 6LR. 
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ARMed and Ready for Battle 


Something's stirring down at the ARM factory, and David Spencer takes a 


closer look. 


t is now over a year since Acorn spawned 

ARM Limited - a company whose aims 
were to continue the development of the 
ARM chipset as used in the Archimedes. 
The rationale behind this split was that 
Acorn’s core business was to produce 
computer systems, and as such they were 
not the best people to develop and promote 
a processor chip set to be used by others. 


When ARM Ltd. was formed, Acorn had 
equal shares with a company called VLSI 
who are the American semiconductor 
company that manufactures the ARM 
chipset for Acorn. However there was also a 
smaller but not insignificant shareholder - 
Apple. As many will know, Apple 
Computer Inc. started life as a company 
formed from by a group of hobbyists, and 
developed into the fastest growing company 
in history to end up as the producer of the 
Macintosh - until now the mainstay of 
desktop publishing. The question is, why 
were Apple interested enough to invest in 
ARM Ltd.? Initially, it was said to be purely 
financial, and this seemed plausible as 
Apple and VLSI work closely together on 
custom chips used by the Macintosh. But 
then, people started saying that perhaps 
Apple wanted to use the ARM chipset in 
their next generation of laser printers. Again 
plausible, as more and more printers are 
using RISC technology for speed. But as we 
will see later, Apple’s interest may be much 
deeper than was speculated. 


ARM 1, ARM 2, ARM 3 .... 

Before delving into new developments, 
it will help to look back at the ARM’s 
history. 


When Acorn first developed the ARM 
chipset around 1984, it was to produce a 
replacement computer for the highly 
successful BBC micro. This earlier machine 


used the ageing 6502 processor which itself 
bears some resemblances to a RISC 
processor. So, Acorn built on their 
knowledge of the 6502 and developed the 
32-bit ARM, and its three support chips for 
memory management, I/O control and 
video. At the time, the ARM was unique 
and arguably became the world’s first 
commercially available RISC processor. 


The original ARM was followed by the 
ARM2 which fixed a few ‘bugs’ in the chip 
and added support for co-processors. From 
a manufacturing point of view, the ARM2 
also reduced the size of the individual 
features on the chip from 3 microns to 2 
microns, reducing the physical size of the 
silicon chip. 


Next in line was the ARM3 which took 
the entire ARM2 almost unchanged, shrunk 
the size again, this time to 1.6 microns, and 
added a four kilobyte cache to the chip. The 
function of the cache has been covered at 
length in previous articles (for example in 
Volume 2 Issue 8), but basically it provides 
isolation between the memory sub-system 
that must run relatively slowly, and the 
processor core that can run much faster. The 
cache holds frequently read data allowing 
the processor to access it at full speed 
without having to slow down for the 
external memory. 


ENTER ARMO6G 

The first development to come out of 
ARM Ltd. is termed the ARM6 (where did 
ARM4 and ARM5 go?). The ARM6 is 
basically an ARM2 with a few subtle, but 
vital changes. First, a full 32-bit address bus 
has replaced the 26-bits used until now. 
Next, the feature size has been reduced to 1 
micron, and the chip implemented entirely 
as a Static device. The previous ARM chips 
were all dynamic, which meant that if the 
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master clock was stopped, or slowed down 
too much, all the information stored in 
registers and the like would just leak away. 
The static design of the ARM6 means that 
the clock can be stopped without losing any 
data. This also reduces idle-time power 
consumption - something that is vital for a 
battery powered portable computer. Vital 
changes to the process by which instructions 
are aborted if an illegal memory access is 
made have also been made, and we will 
come back to this. 


But the major change in the ARM6 is 
that, unlike its predecessors, it is not a 
complete chip that can be soldered to a 
circuit board, but is rather a design macro 
that can be combined with other macros to 
produce a chip. For example a particular 
manufacturer could license the ARM6 
macro from VLSI and combine it with some 
RAM and ROM and a few I/O devices all 
on a single chip, to produce a custom micro- 
controller. This is only possible because the 
RISC architecture leads to a very simple and 
hence small chip. The ARM6 macro only 
occupies a 2.8mm square of silicon, allowing 
plenty of silicon real-estate, as it’s termed, to 
accommodate other circuits. Compare this 
situation to the other leading processors 
such as the Intel 80486 and Motorola 68040 
where they have problems enough fitting 
the processor onto the silicon, let alone 
anything else. 


Obviously, the ARM6 as a macro cell is 
of no use to anyone outside a silicon design 
house. Therefore, ARM Ltd. has packaged 
the ARM6 along with other circuits to give a 
new range of ARM processors. The first of 
these is the ARM60 which is just the ARM6 
in a physical package. It is basically a fast, 
low-power ARM2 with an extended address 
range (4GBytes instead of 64MBytes). The 
ARM60 is likely to be used in portable 
computers where low-power consumption 
is the vital criterion. 


Second in line is the ARM61. This is 
similar to an ARM60, but only uses 26 bits 


RISC User March 1992 


of the address bus allowing it to be a pin- 
compatible equivalent to the ARM2. You 
could therefore pull out your ARM2 and 
replace it with an ARM61, reducing power 
consumption and allowing a higher 
operating speed, providing the memory can 
handle it. 


Of most interest, though, is the new 
ARM600. This is an ARM6 core, with the 
addition of the ARM3 cache system, a write 
buffer and a new memory management unit 
(MMU). On the ARM3, all write operations 
slowed the processor down, as they always 
went directly to the external memory, 
bypassing (though possibly updating) the 
cache. On the ARM 600 this situation is 
improved by the new write buffer. All write 
operations now take place at full speed into 
this buffer, which then writes them out to 
memory at a slower speed. 


The MMU performs the function of 
mapping logical addresses generated by the 
processor onto physical memory addresses - 
a job until now done by the memory 
controller MEMC. The ARM600 allows 
memory to be split into either sections of 
1MByte each, or pages, which can be 4K or 
64K in length. When a memory access is 
made, the address is used to look up the 
address in a table. If the address 
corresponds to a section access, the table 
entry is used to generate a physical address. 
This is very similar to the current system. 
However, if the entry is for a page access, it 
is used to look up in a further table to give 
the physical address. The initial table is held 
in external RAM, but to speed up accesses a 
32-entry cache called the Table Lookaside 
Buffer (TLB) is used to hold details of the 
most frequently accessed sections. This 
system allows both for fast task switching as 
used by RISC OS, and the disc-based virtual 
memory of RISC ix. 


The MMU also provides access control 
to the memory, deciding what type of 
program can access any particular part. 
However, unlike MEMC, the protection is 
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separated from the memory mapping, with 
the 4GByte logical address space being split 
into sixteen domains. The accesses to 
addresses within each domain are controlled 
by 2-bit fields in a register called the domain 
access control register. Setting this register 
controls whether the current program has 
Client access, Manager access or no access to 
a particular domain. A Manager has 
unrestricted access to a domain, while a 
Client’s access is vetted. It is the job of the 
Manager to control the access given to 
Clients. 


devices, provision has been allowed for 
traps to be recognised right through the 
instruction cycle, rather than just during 
the first half. This gives the MMU more 
time to decide whether an access is legal 
or not. 


To summarise, figure 1 shows the steps 
taken in generating a physical address 
from a logical address during a memory 
access, and the various traps that can be 
taken. 


Logical address 


Check address alignment 


Seen. bees 


Get page 
table entry 


lo access (00; Check domain status 
Page Reserved (10) fault 


served (10) Section 


Alignment 
fault (Address 
exception) 


Page 
invalid > translation 
fault 


Page 


lo access (00, domain 


a) ia 
amen ti) 


bert Violation > Check access] | [Check access 
Sat ion permissions permissions 


Subpage 
Violation > permission 
fault 


Figure 1. Mapping 4 logical address to a physical address 


If a memory access fails for any 
reason, for example because of an illegal 
address, an undefined mapping, or a 
protection violation, one of a number of 
traps is taken. The operating system can 
then decide what action to take and 
resume execution. To make the trap 
system more flexible than on earlier ARM 
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AN OBJECTIVE VIEW 

So just why does the ARM600 have such 
an apparently complex system of memory 
mapping and protection? The answer is that 
it is ideally suited to a style of programming 
called Object Orientated Programming 
(OOP). OOP can be thought of as the 
ultimate in structured programming. All 
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data within an OOP environment is in the 
form of objects, with each object falling into 
a class, depending on its type. A class can be 
anything from a simple integer, to a laser 
printer. All operations on objects are 
performed by self contained ‘black box’ 
programs that only communicate via 
objects. The collections of programs that can 
operate on objects from a particular class are 
termed the methods for that class. 


An OOP operating system running on 
an ARM600 could use the individual 
domains to represent the different classes. 
For each program, the classes of objects it 
could operate on would be controlled by 
setting the access bits for each domain 
accordingly. The paged memory system 
could be used to implement the individual 
objects in a virtual memory system with 
them stored either in memory or on disc. 
The transfers between memory and disc 
would be performed transparently by the 
operating system. Taking this to its limits, 


the distinctions between memory and files 
vanishes completely. 


So back to Apple, and their involvement. 
Only a few months after ARM Ltd. was 
formed, Apple and of all people IBM 
announced a joint project to develop a 
future range of computers using an object- 
orientated operating system, but not based 
around a 680x0 type processor. Could it be 
that the ARM600 will form the basis of these 
machines? If it does, and only time will tell, 
it will not only be a triumph for Acorn and 
ARM Ltd., but also for the British 
semiconductor industry as a whole. 


But what about Acorn and the 
Archimedes in this. The ARM600 doesn’t fit 
neatly into the existing Archimedes 
architecture, and it is probably very unlikely 
that we will see ARM600 cards for the Arc. 
What is more likely is that the next few years 
will bring a new range of RISC OS computers 
from Acorn, either with a redesigned 
architecture to accommodate the ARM600, or 
perhaps a further ARM6 variant. Au 


Transfer, the NEW utility that lets you copy text from any icon in any RiscOS application and transfer it to 
any other. 


The copied text can be inserted into other text, or it can replace it. You will find many uses for Transfer as 
it makes the contents of practically all field or writable icons, ‘drag-able’ between applications. It also lets you 
drop the text into documents as well as icons. An obvious use would be to grab a name and address from a 
database and deposit it into a word processor, (or even another database). 


Transfer is itself, a RiscOS application and sits on the icon bar. A simple menu gives you complete control 
of its actions. 


It is simplicity itself to use. All transfers are carried out by mouse clicks. Point and click at the text you want, 
then point and click again to deposit it. It is invisible to applications and does not interfere in any way with 
their operation. Transfer will work on any Archimedes series computer. 


Transfer is only available from Apricote Studios, 2 Purls Bridge Farm, Manea, 
Cambs, PE15 0 t (035 478) 432 


£8.95 


inc. VAT & p&p 


Access 
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Illusionist 


Can Clares’ Illusionist provide the graphical sleight of hand its name suggests? 
Richard Hallas has been trying out this new application and now reports. 


12 


hortly after issuing its updated ray- 

tracing package, Render Bender II (see 
review in RISC User Volume 5 Issue 1), 
Clares has released a new 3D art package 
which at first sight looks to be quite similar. 
Written by David Hoskins, author of 
Superior's ‘Speech’ for the BBC Micro, 
Illusionist is not, however, a ray-tracer, 
avoiding the long-winded ray-tracing 
approach. Instead, it constructs a picture 
in terms of visible polygons. The facilities 
are therefore quite different to those 
provided by Render Bender. 


Scenes created by Illusionist cannot 
have shadows, mirrored surfaces or glass 
objects which refract light, but the range 
of other facilities available includes 
coloured light sources, sprite and texture 
mapping, full colour support (including a 
24-bit clear format, suitable for use with 
Translator) and a wide range of basic 
graphic primitives. Rendering scenes with 
Illusionist is very much faster than ray- 
tracing; a full mode 15 screen at best 
quality takes perhaps half an hour on an 
ARMS machine. 


THE PACKAGE 

Illusionist comes in a rather flimsy slim 
cardboard wallet. There are two discs and a 
manual which is glued into the wallet. The 
first disc contains the main application, a 
copy of !System and a few associated 
utilities, along with some texture maps 
(wood, marble and brick) and example files 
for use with the tutorial section of the 
manual. The second disc contains a small 
number of very impressive pictures, and 
some Illusionist files for you to render 
yourself. 


The 54-page manual is very nicely 
presented and easy to follow, with helpful 
illustrations and plenty of examples. There 


is a tutorial section at the back which can be 
read before the rest of the manual, so eager 
new users can see what the package can do. 
The content of the manual is good, but the 
same cannot be said of the grammar, which 
is atrocious in places. My comments about 
the Render Bender manual were similar. 
Clares really should employ someone who 
can write English! 


[S1G) sdf: Marddisot.$, Graphics I1N{ tik 


IN USE 

Illusionist is loaded as a single 
application onto the icon bar, as opposed to 
Render Bender which forms a suite of 
applications. However, the application is in 
fact a front-end to the drawing ‘engine’, 
which takes the form of a relocatable 
module. Clicking on the icon bar icon opens 
the main drawing window. 


Opening windows and double-clicking 
on files associated with Illusionist causes 
Macintosh-style zooming boxes to fly 
around the screen, which is slightly 
disconcerting if you're not expecting it. The 
main window consists of four ‘panes’ and a 
toolbox (which is actually in the window, 
rather than at the side as with Draw). Three 
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Illusionist 


green panes provide views into the 3D scene 
you are creating. The fourth, white pane, 
shows a 3D wireframe view of the scene (see 
figure 1). 


Illusionist provides a large range of 
graphic primitives, and more unusual ones 
such as vases, cups etc. can be created in the 
excellent Sweep editor. This allows not only 
straightforward symmetrical shapes to be 
created, but in addition, objects like springs 
or cables which curl around many times can 
be created by specifying a rotation factor 
greater than 360%. When placed in the 
scene, the shape you selected appears as a 
collection of dots joined by many black 
lines, which tends to give a rather muddy 
appearance. 


figure 2. The final rendered image 


Since Illusionist works with polygons 
rather than solids, any of the points 
constituting the solid’s surface can be 
selected individually, and used to distort a 
standard shape in an infinite variety of 
ways. Like Render Bender, Illusionist 
encourages the creation of one-sided figures, 
and these can easily be created by plotting 
points in one of the view panes, and then 
using the polygon maker tool to join the 
dots. If necessary, the shape can be extruded 
to make a solid. 


Once created, your shape can be 
manipulated in a large variety of ways, 
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including rotation about and scaling along 
any or all of the three axes. An invaluable 
feature is the ability to give a group of 
points a label. Once labelled, clicking on the 
name of the group in the label window with 
Select and Adjust will select and deselect 
those points. Using the Material editor, each 
individual shape can be given a property 
(matt, shiny, metal, plastic, luminous, 
smoothed/normal, single /double-faced), 
and colour or map. Any object can be given 
any colour, selected from the entire palette. 
The colour currently selected is shown in 
the screen border, so you can see exactly 
what you have selected, even in 16-colour 
modes. This is a very good idea. 


As an alternative to using a simple 
colour, a mode 13 or mode 15 full-screen 
sprite can be mapped onto the object. This is 
a very powerful feature indeed, since the 
mapping is very flexible. Maps can be 
rotated and distorted, and it is possible to 
repeat the map a number of times over the 
object. In addition, objects can be given a 
mirroring effect by reflecting a specified 
amount of sky and ground colour (which 
can be chosen from a predefined list). 


An unusual and powerful shape 
available is the Surface, which consists of a 
square 2D grid of connected points and 
initially appears flat. Any of the points can 
be moved, thereby allowing the creation of 
exotic shapes (surfaces) which would 
otherwise be difficult to achieve. A novel 
tool, useful in conjunction with the Surface, 
is the magnet cursor, which attracts selected 
points. They flock to it at different speeds, 
according to their relative distances from it. 


As well as the various shapes which can 
be created, the observer position and viewing 
direction can, of course, be positioned 
precisely, along with up to 14 lamps. The 
lamps can be either point or spot lights, and 
the spread, distance and colour of the light 
they produce can be set to any value. 


When your picture is ready for the full 
rendering, there is a further range of options 
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available. Any 256-colour screen mode may 
be used, and you can set whether or not the 
environment (the sky and ground) is to be 
included in the picture. Anti-aliasing can be 
applied, and there is also an advanced 
colour matching algorithm. These two 
options improve the quality of the final 
picture, but slow the plotting considerably. 
If a PCATS graphics enhancer is fitted, 
Illusionist can use it to redefine the palette 
and improve the picture quality. 


CRITICISMS 

Comparisons are bound to be made 
between Illusionist and Render Bender II. 
From the above, and bearing in mind that 
Illusionist is £35 cheaper than Render 
Bender, it would appear that Illusionist 
should win hands down in terms of 
features. From the quality of the final result I 
would say that it is very difficult to beat, 
since it can produce some quite stunning, 
true-to-life pictures (see figure 2) which 
Render Bender would be totally incapable of 
creating. However, the Illusionist editor, 
despite its comprehensive list of features, is 
very poor competition for Illuminator, the 
Render Bender II scene editor. 


Illuminator has six separate windows, one 
for each view onto the scene. Each of these 
can show the scene in wireframe or solid 
views, with appropriate colours, under 
different zoom settings, and can be resized, 
opened and closed independently. These view 
windows also make full use of high 
resolution screen modes. In contrast, 
Illusionist is very limited. It has only three of 
the six possible views available, and they are 
fixed, so you cannot edit an object from 
behind. The zoom option works on all the 
views at once, and the panes which display 
the views are very small and cannot be 
resized because they are all in one window. 
Therefore if you are doing detailed work ona 
scene, you either have to zoom out and then 
zoom back in again on a different area, or 
spend a lot of time panning around the scene. 


For the more technically minded, instead 
of being true windows, the views are in fact 


sprites shown within large icons, and it is for 
this reason that they cannot be resized. If you 
are fortunate enough to own a multisync 
monitor, you will be annoyed to encounter 
another drawback created by this method of 
programming. No use is made of high 
resolution modes at all, and the view 
windows simply double the width of the lines 
(since the sprite is scaled to fit the window). A 
further annoyance about the Illusionist editor 
is that although it is fully RISC OS 
compatible, it has a number of little quirks 
that make it quite unlike any other program 
of this nature I have encountered. One of 
these is the need to use two of the mouse 
buttons simultaneously when plotting points. 


CONCLUSIONS 

The above criticisms may make Illusionist 
sound less than it actually is. The drawing 
module itself is nothing short of superb, and 
the quality of the final pictures is truly 
stunning. I just feel that the editor could be 
better than it is, although it is by no means 
bad. It just isn’t nearly as good as Illuminator, 
and cramps the abilities of an otherwise 
excellent package. You can get used to it, 
though, and it is at least virtually bug-free. If 
the author would add separate, independent 
viewing windows and a slightly more 
conformist interface, | would have no 
complaints at all. There is also no provision 
for creating animations, though if you have 
both Render Bender and Illusionist, you 
could use the Render Bender Animator to 
create them from separate scenes. 


In short, this is an excellent package, and 
very good value for money, but it is slightly 
let down by its editor. If 1 were to choose 
between Render Bender II and Illusionist, 
though, I would certainly go for the latter 
because of its greater realism, flexibility and 


much higher quality of output. 
Product Mlusionist 
Supplier Clares Micro Supplies 
98 Middlewich Road, 
Northwich, 
Cheshire CW9 7DA 


Tel. (0606) 48511 
£99.95 inc. VAT 
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Scrap Value 


David Spencer delves into the secrets of the new !Scrap application from Acom. 


FIRST !System 

Most users will be familiar with the idea of 
the cs apie directory, even if they don’t know 
exactly what it’s for. Basically, System is a 
pseudo-application performing two functions. 
Firstly, it provides a place to store relocatable 
modules and other system resources that may 
need to be accessed by several different 
applications. This alleviates the need for each 
application to have its own local copy of a 
universal resource, such as the shared C 
library module (CLib). 


A second, less obvious, use of !System is to 
provide the full pathname for a temporary file 
that can be used by any application. The 
intended use of this is as part of the protocol 
for transferring data between two applications 
when one or both of them can’t cope with a 
direct RAM transfer. What happens in a 
nutshell is that the sender of the data saves it 
using the temporary filename, and the 
receiver loads it from the file which is then 
deleted. The filename is held in a system 
variable (Wimp$Scrap) set up when a filer 
window containing !System is first opened. 
The filename used is ‘ScrapFile’, within the 
!System directory itself. 


This method for nominating and accessing 
temporary files does have a potential 
drawback: in a multi-tasking environment, 
several applications could try to use the same 
temporary file simultaneously, as there is only 
one !System. In practice, this isn’t normally a 
problem because as long as the applications 
involved in the transfer follow the correct 
protocol exactly, the Wimp ensures that one 
transfer finishes before the next can start, and 
no conflict occurs. Consider, though, what 
_ happens on a networked computer where 
!System resides on the network. It is possible, 
and indeed not unlikely, that two computers 
will try to use the single temporary file at 
exactly the same time. The results? Chaos. 


ENTER !Scrap 

One solution to the conflict problem 
would be to provide each user with their own 
copy of System, but this is both wasteful of 
disc space, and it would be a nightmare to 
update the common resources held within 
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!System. To get around this, Acorn have split 
the problems up and provided two 
applications - !System for common resources 
and !Scrap for storing the temporary file. 
Normally, a user would have both !System 
and !Scrap in their root directory, but on a 
network there would be a single copy of 
!System, but a copy of !Scrap for each user, 
this being stored in the user’s own directory 
on the network. As !Scrap is really no more 
than an empty directory, it occupies little disc 
space and is unlikely to need updating very 
often, if at all. 


There is also a benefit in !Scrap for users of 
floppies. !Scrap is small enough to have a copy 
on each of your working discs. If you then 
make a point of double-clicking on !Scrap each 
time you insert a disc, this copy will be used 
in preference to any others, and you will no 
longer be continually inserting the disc 
containing !System (except to load shared 
resources.) 


In fact, there are two variants of !Scrap. 
The first, which has been distributed 
alongside !System with various pieces of 
software, simply sets the system variable 
Wimp$Scrap to make the temporary file name 
‘ScrapFile’ within the !Scrap directory. 


The second, newer version of !Scrap first 
appeared with RISC OS 3, but is also being 
distributed in products, along side !System. 
This improves on the earlier version by 
allowing a single copy of !Scrap to be used on 
a network, rather than one per user. It does 
this by putting the temporary ‘ScrapFile’ in a 
sub-directory of the !Scrap application. When 
run from anything other than a network, the 
directory used is called ‘ScrapDir’. On the 
other hand, if !Scrap is run off a network, the 
directory name is ‘Stn@@@!###’, where @@@ 
represents the network number, and ### the 
station number. This ensures that each 
computer has its own unique scrap file. 


USING !Scrap 

So much for the theory: how do you 
actually use !Scrap? Well, basically you just 
install it along side !System, and then ignore 
it. All the work is done automatically whey 
needed. Simple really. 4 


1S 


Following glowing reviews in the computer press .. 


.. @ New version of Des kEdit (V 1.20) 


has now been released 


rob vt sent) leet eee | 


with even more sO 
features for text | 
editing and word 
processing tasks, 
Basic and C 
source editing 


A new single key 
save-and-run feature in Basic mode, permits virtually 
instantaneous testing of programs and applications as you edit 
them. To make Basic editing even easier, an automatic LISTO 1 
is applied when numbered programs are loaded (and the 
spaces are automatically removed on saving) 


The improved procedure and function browser now lets 
you browse procedure and function definitions in both 
directions (Cul-D takes you to the next definition, while Cul- 
Sh-D takes you to the one above etc). 


In text mode, wordwrap control has been improved, while in 
C mode syntax checking has been extended, and a special Search 
option lets you search for function definitions 


DeskEdit 


is the ultimate all-purpose editor for the 
Archimedes, with special features for 
use with plain text, Basic and C source 

Edit your Basic programs on the 
desktop and test them interactively 
with a single key press 


DeskEdit features 


Three special Find and Replace modes - from Simple to 


Other new features are; « dynamic date insertion, « Left and 
Right Justify, ¢ bracket matching, ¢ Align Columns and the Char 
Info option (Ctrl? puts up a box giving the ASCII code of the 
character at the caret in hex and decimal, and any special 
function it may have - e.g. Bold On etc.) 


Language specific features: 


Plain text 

* DeskEdit will format word-wrapped text as you type 
Basic 

© Drag a Basic file to the icon, and it will automati-cally be 


Power Search 

* Additional Quick-Search mode for rapid retrieval 

* Text macros to insert user strings in both text and source 
code 

* Special Undelete buffer for moving text around, in addition 
to Edit-style Undo/Redo 


around large files 


¢ Dedicated markers and position finders for finding your way 


detokenised and loaded into DeskEdit ready for editing 
Press F3 to retokenise and save it after editing. 
Optional line number stripping. 

* Auto indent, automatic line number insertion, and 
checking for matched brackets and quotes - as you type 
Special Basic browser: 

Cul R steps through all REM lines 
Ctrl D steps through all procedure and function definitions 
Ctrl P steps through all procedure references 


Ctrl F steps through all function references 

C language 

¢ Asimple syntax checker which operates as you type 
Auto indent facility combined with automatic generation 
of opening braces streamlines source code entry 
C Function browser 
Grl-F steps through function definitions 


¢ Clipboard, providing an alternative way to move text around 


* Onscreen Help - full documentation in a scrollable window 

¢ Instant file info feature, and current directory setter 

* Caret flash controller for DeskEdit and other applications 

* Customised user commands to open directories, run other 
applications and launch Obey files 

* Numerous keyboard shortcuts 

* Fast text printout including style codes for bold, underlirre, 
italics, page breaks etc 

© Special text printing options with headers, footers, page 
numbering and style codes. 

* Preview mode 

* Statistics option - a brief summary of aspects of the text to be 

printed, including character, word, line and page count 


DeskEdit is supplied with a 48 page manual and a function keystrip 
Members’ Price £19.95 inc. VAT. + p&p Stock Code PEDTb 
Existing users may upgrade to V_ 1.20 by sending their onginal disc 
together with £2.00 and SAE marked DeskEdit Upgrade 1,2. 


RISC Developments ta. 


117 Hatfield Road, St Albans, Herts, AL! 4S 
Tel. 0727 40303 Fox 0727 860263 


Veni Vidi Archimedes ———— 


J].A.Rowan assesses a new low-cost video digitiser from Rombo called 


Vidi-Archimedes. 


idi-Archimedes is a new video digitiser 

made for the Archimedes series of 
computers by Rombo (a new name to the 
Archimedes world but not in digitisers). It 
can process both black and white and colour 
images subject to certain limitations detailed 
below, yet at the time of writing it is the 
cheapest digitiser available, costing quite a 
bit less than some monochrome-only units. 


VISE ehimeses 


The Vidi-Archimedes interface 


WHAT YOU GET 


The hardware consists of a half-width 
expansion card, together with suitable 
fittings. The A3000 version is cased, while 
the other type comes with mounting ears 
and a half-width blanking plate. Installation 
of the internal type is simple, and detailed 
instructions and illustrations appear in the 
manual. Video input to the unit is by phono 
connector, and a_ phono-to-phono 
connecting lead is supplied. The digitiser 
also has an S-VHS connector on the rear 
panel. Two floppy discs are supplied with 
the unit, one containing the operating 
software and the other the !Slideshow 
application bundled with Vidi-Archimedes. 


The construction of the card is 
professional, with a good-quality PCB and 
excellent soldering. There were two short 
wire jumpers on my board, but these were 
neat and well-soldered, and I can’t see them 
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justifying a new board layout. The board is 
attached to a single aluminium panel which 
forms the screening plate and rear panel, 
and the unit as a whole felt solid and stable. 
The installation instructions suggest that the 
computer's cover can be left in place, but 
my Arc seems to have rather wide mechanical 
tolerances and I chose to remove the cover to 
make sure the card was plugged in fully on 
the backplane. The manual explains in detail 
how to check that the unit is working properly. 


PERFORMANCE 

The digitiser is basically a monochrome 
unit, and its analogue-to-digital converter is 
fast enough (at 2 fps) to work in real time. 
This means that a field can be grabbed 
instantly, rather than requiring a picture to 
be stationary for several seconds. The unit 
also contains a PAL decoder, which can 
separate colour video into red, green and 
blue components. It must then digitise these 
in turn, and here is the main drawback of 
the unit: a colour picture must be stationary 
for the second or so that it takes to store all 
three colour separations. The manual does 
emphasise this point, and goes on to say 
that the freeze facility of a home VCR is 
unlikely to provide a clean and stable 
picture for capture. With a lot of patience 
and rewinding, I was able to get the 
occasional good-quality colour picture from 
my VCR, but if you really need this facility 
then you must look for a much more 
expensive unit. Many of the less expensive 
colour digitisers share this limitation, by the 
way. If you only need monochrome, then 
there is no problem grabbing a field from a 
moving VCR picture. 


The digitiser produces mode 9 sprites, 
one for monochrome and three for colour, 
each with 16 grey-scale levels. It will then 
combine the latter three to produce a single 
mode 13 or 15 colour picture, though with 
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only 256 colours available something must be 
lost in the translation. The software can also 
produce TIFF format files for export to those 
nasty foreign computers. Mode 9 sprites are 
320 pixels by 256, which is quite a low 
resolution as digitisers go, but is adequate 
for the limited display facilities of the 
standard Archimedes. A PAL decoder has 
to be expensive (well over a thousand 
pounds) before it can deliver a horizontal 
resolution of more than about 250 pixels, 
and you need at least a VGA monitor 
before your Arc will display more than 256 
pixels vertically. Having said that, Rombo 
had a stand at the December Computer 
Shopper show, and a large monitor was 
displaying some superb colour pictures 
grabbed using the Vidi-Archimedes. 


SOFTWARE 


The speed of the digitiser allows 
simple monochrome animation, able to 
handle a couple of pictures per second, 
giving the sort of strobe effect rather over- 
used on “youth” TV. A separate program, 
using video-recorder-type controls, allows 
easier storage and examination of such 
sequences. To be honest, I am not sure there 
is a large market for this feature, since it 
cannot work in colour, though there may be 
some applications in image analysis. This 
leads on to the major shortcoming of the 
software supplied with the Vidi-Archimedes. 


Having digitised a picture, that’s it. 
There is no additional software to either 
enhance or analyse the image, to reduce 
noise or alter the colour balance. The latter 
item can be adjusted before grabbing, but 
not afterwards. It is possible to extract the 
individual red, green and blue components 
of a colour image as sprites, but not to 
reinsert them after, say, a little editing in 
Paint. The manual does contain a large 
amount of information on the data and file 
formats used, so a programmer would have 
no real problem building suitable software, 
but a few examples of processing techniques 
would have been useful. On the hardware 
control side, full details of the operating 


SWIs are given, along with a couple of 
example programs to demonstrate their use. 
The card contains a switch input socket, and 
software is given to use this to provide a 
remote grab control. 


Vidi-Archimedes in use 


There is also an application called 
Slideshow, from 628 Software, provided with 
the Vidi-Archimedes. It is a display system 
for full screen sprites of modes 9, 12, 13 or 
15, and will show each sprite for a pre- 
determined time, and then move to another 
in one of twenty-eight different types of 
transition. It is also possible to hold some or 
all screens until a key is pressed, to facilitate 
slide-assisted lectures. Naturally, this 
software can use the sprites produced by 
Vidi-Archimedes, and a short demo 
sequence of such sprites is provided. For 
commercial use of this software, distribution 
of the run-time display-only system is freely 
permitted by 628 Software. 


ERGONOMICS 

I can’t really say that the main operating 
software is intuitive and simple to use. Like 
any system, familiarity comes with practice, 
but it seemed to take too long to come to 
grips with the operating philosophy. 
Loading and saving pictures seems 
unnaturally complicated, largely due to the 
fact that colour pictures must be treated as a 
sequence of sprites, and therefore handled 
differently to the single monochrome sprite. 
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Colour pictures may also be saved in the 
form of the composite mode 15 sprite, 
though the separations cannot later be 
recovered from this. 


A digitised image from an original photo 


Some of the system’s drawbacks are 
rooted in the Arc itself: to display a 
recognisable picture while waiting to make 
a grab, the Desktop must be operated in 
mode 9 with a pure grey-scale palette. The 
software handles the change automatically, 
and after the grab is made will return to the 
previous Desktop mode and palette, but 
before the grab the screen is really murky 
and difficult to use. Again, after a colour 
grab the composite mode 15 picture is 
automatically assembled and displayed, but 
to see a stored monochrome picture with the 
correct grey scale it is necessary to alter the 
Desktop palette manually, and back to 
normal afterwards. 


The brightness of the digitised picture 
can be adjusted by software, but there are 
also brightness, contrast and colour 
saturation (intensity) controls on the card 
rear panel. On my review unit, they were 
just barely able to be set to correctly digitise 
a standard level video signal. Some form of 
maximum and minimum video level 
monitoring on the Desktop control panel 
(Card Manager) window would be useful to 
those without access to test equipment. 
Something that the software can detect is 
whether there is an input video signal at all. 
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It seems, in fact, unduly sensitive to this, and 
frequently when switching video inputs or 
channels on the VCR TV tuner the detector 
would display a dialogue box telling me that 
video had been lost. I had to acknowledge 
this message and then re-enter the grab 
mode, with a loss of several seconds each 
time this happened. Perhaps a small time- 
out period could be allowed before the 
software decides there is no input video? 


DOCUMENTATION 


Like most manuals, once you know what 
you are doing, this one is quite good. 
Installation instructions are clear and are 
illustrated, naturally, with pictures digitised 
by Vidi-Archimedes. The short get-you- 
started section allows a beginner to check 
that the system is working properly without 
delay, though the transition to a full 
description of operation is a little abrupt. A 
short tutorial covering all aspects of 
operation would be more useful than the 
description of menu options, though the 
latter of course is essential. As mentioned, 
there is a full description of data formats 
and the example programs are in Basic V. 
There is also advice given on using lighting 
and cameras for best results, a side of 
digitising not often discussed. 


CONCLUSION 


This digitiser has limited performance, 
and is not suited to the export of high 
resolution colour separations to printing 
machinery, nor to grabbing moving colour 
pictures. If, however, you are looking for 
pictures to display on a_ standard 
Archimedes without a fancy graphics 
adaptor and monitor, or are interested in 
exploring image analysis software 
techniques, or are just looking to digitise 
graphics that won't fit under a scanner, then 
it is difficult to imagine a more cost-effective 


solution than the Vidi Archimedes. 
Product Vidi-Archimedes 
Supplier Rombo 


Baird Road, Livingston, 
Scotland EH54 7AZ. 
Tel. (0506) 414631 

Price £175.08 inc. VAT 


Font Name Conflicts 


Alan Wrigley explains how font names can sometimes be a problem, and 
presents a program which offers a partial cure. 
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he proliferation of outline fonts available 

for the Archimedes has brought with it a 
problem which has caused a great deal of 
confusion to some users, and that is the 
question of font names. Many of the fonts 
on the market have been designed to be 
equivalent to a standard printer’s typeface, 
such as Helvetica or Times. These typefaces, 
along with a number of others, are normally 
available as built-in fonts on PostScript 
printers, or are separately downloadable to 
the printer. 


When Acorn developed outline fonts for 
the Archimedes, for reasons of copyright the 
names for its fonts were chosen to suggest 
the equivalent PostScript font without 
actually using its name. In fact, Acorn chose 
Cambridge college names for its fonts, and 
thus Homerton is equivalent to Helvetica, 
Trinity to Times, Corpus to Courier and so 
on. When using these fonts with a PostScript 
printer, the printer will not recognise these 
names, and so the prologue file sent to the 
printer by the printer driver contains the 
necessary code to translate the names into 
the more recognisable PostScript font 
names. This is all done automatically by 
PrinterPS, and provided that you use only 
Acorn’s fonts you will not have to concern 
yourself with this at all. 


Unfortunately, this is not the end of the 
story. Other companies have produced their 
own equivalent fonts with their own unique 
names; for example, RISC Developments’ 
SwissB is equivalent to Helvetica or 
Homerton, while its Paladin is the same as 
PostScript Palatino or Acorn’s Pembroke. If 
you are using any of these fonts with a 
PostScript printer, you must alter the printer 
driver's prologue file, otherwise you will 
simply not be able to print them. The !Help 
file inside PrinterPS gives some information 
on how to do this, and further instructions 
are given in comments within the PSProlog 


file itself. Often the supplier of the font will 
provide a suitable substitute PSProlog file. 


There is another problem which may 
occur (and often does) when document files 
are used on more than one computer, since 
each of the machines may have a different 
set of fonts installed (even though these may 
be the “same” fonts under different names). 
When applications which are designed to 
handle outline font text start up on the 
Archimedes, they normally read the font 
catalogue to see which fonts are available. 
Now suppose that you have prepared a DTP 
document on one machine using certain 
fonts, and you then try to load that 
document into the same package on a 
second machine which does not have those 
fonts installed. How will the application 
cope with this? 


In the case of Ovation, you will get a 
message informing you that the fonts are 
not available, with an offer to re-flow the 
document in the default font. Impression 
also reports that the fonts are missing but 
substitutes them with others without further 
ado. There are two problems with this. 
Firstly, although there may be a number of 
missing fonts, only the first in the list is 
reported, so you will have no idea which 
others cannot be found. Secondly, 
everything will be re-flowed in the default 
font, and there will be no way of telling 
which parts of the document are in different 
fonts unless you have consistently used 
paragraph styles throughout; even then, you 
will not know which actual font was used 
for each style. 


It does not make sense to load up large 
numbers of fonts each time you use your 
Arc, particularly if some of them are direct 
equivalents of others with different names. 
Perhaps what is needed in the long term is a 
radical re-think by Acorn and others of the 
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Font Name Conflicts 


whole question of font names, but until 
then, the simplest solution is to temporarily 
rename a font if you need to use its 
equivalent in a particular document. 
Unfortunately, there is more to this than 
merely changing the filename of the font’s 
directory; the font name is also embedded in 
the IntMetrics and Outlines files, and the 
correct format of these files must be 
maintained. 


The listing given here is intended to be 
added to the Icon Bar Shell (RISC User 
Volume 4 Issue 7), and will automatically 
take care of all the necessary processes 
involved in changing a font’s name. Load a 
copy of the original shell program into 
Basic, remembering to alter line 530 to 
DEFPROCerror as described in Points Arising 
(Volume 4 Issue 8). Delete line 720 which is 
not required in this application, and then 
replace lines 890 onwards with listing 1 
given here. Then save it as the new 
!RunImage. You will need to set a WimpSlot 
of 16K in the /Run file. 


When the new application is installed on 
the icon bar, dragging any font directory (i.e. 
the directory which actually carries the font 
name) to it will first prompt you for the new 
name, and then rename the font. The 
program looks for Outlines and IntMetrics 
files, and operates recursively on any sub- 
directories so that all weights and styles 
pertaining to that font will be altered. Thus 
changing Paladin to Pembroke will also alter 
Paladin.Roman.Italic to Pembroke .Roman.Italic 
and so on (but not to Pembroke.Medium.|talic). 


If you are submitting articles or artwork 
to RISC User or other magazines, don’t 
assume that the recipient necessarily has the 
same set of fonts as yourself. It is best to 
include a covering note or a ReadMe file 
detailing the fonts used, as there is no easy 
way to find this out other than by trial and 
error. 


’ 
ho 
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930 IF name$="Outlines* foundt=TRUE EL 
SE IF numt>0 AND obj%=2 leaf$+=". "+names 
:next=0 

940 IF len$>length? lengtht=len% 

950 UNTIL numt=0 OR founds 
ENDIF 
IF found’ THEN 
mem’=HIMEM: sizet=mem’-£8000 
Q SYS "Wimp_SlotSize*,sizet+lengtht+ 
20,-1 TO newt 

1000 IF newt=size$ THEN 
1010 PROCreport ("Not enough memory") 
1020 ELSE 
PROCconvert 
1040 SYS *Wimp_SlotSize*,size%,-1 
1050 ENDIF 
1060 ELSE 
1070 PROCreport (*Not a font directory*) 
1080 ENDIF 
1090 ENDPROC 
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1110 DEFFNsearch 

1120 SYS "OS_GBPB*,10,pathname$+leaf$,b 
lock$,1,next%,256,"°** TO ,,,numt,nexc$ 

1130 ptrt=blockt+20:aS="* 

1140 obj$=block?!16:lent=blockt!8 

1150 WHILE ?ptr$<>0 

1160 a$+=CHRS (?ptré) :prrt+=l 

1170 ENDWHILE 

1180 =a$ 

1190 : 

1200 DEFPROCconvert 

1210 xt=LENpathnameS:REPEAT x$-=1 

1220 UNTIL MID$(pathnameS,x$,1)=°.° 
1230 path$=LEFTS (pathnames, x$) 

1240 oldfontS=RIGHTS (pathname$ , LEN(path 
names} -x%) 

1250 $blockt="FontName" 

1260 SYS *Wimp_CommandWindow", lock’ 

1270 INPUT "New font name: “newfont$ 

1280 PROCrename(**) 

329C SYS °OS_FSControl*,25,pathname$, pa 
thS-+newfoncs 

1300 PRINT'*font name changed from “cid 
font$* to *newfont$ 

1310 SYS *Wimp_CommandWindow*, 0 

1320 ENDPROC 

1330: : 

1340 DEFPROCrename(leaf$) 

1350 LOCAL next, out$,name$ 

1360 REPEAT nameS=FNsearch 

2370 IF next$<>-1 THEN 

1380 CASE TRUE OF 


Continued on page 29 
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Two (or more) Computers ? 


Want to share disc drives (or other resources) ? 


Ask us about 


= Back to Back. 


Back to Back provides the ideal way into cost effective computer networking for the home 
enthusiast, small business or school. Back to back is a solution tailored to YOUR needs by OUR 
experts. Now you can share hard-disk units, printers, teletext and other computerised reources 
whether the hardware be in your own home or at your place of business. 

The technical basis of Back to Back is Acorn Computers long established and reliable networking 
system Econet. We have given this a novel twist to remove the complexities which might once 
have made the non-expert fear to take the first steps. 


What does it cost ? 

Typically we can give you full sharing of filing systems between two Archimedes computers for 
£167 or between 1 Archimedes and 1 Master Series computer for £179. 

BUT ... the whole point of Back to Back is that we will quote you a price for a system to meet 
your needs and without obligation. You loose nothing by asking for our advice and we promise 
you that we will tell you if we know of a better solution than Back to Back. 

All of our Back to Back sales include free telephone support. 


But | know about Econet networks. 


Fine - you might not need our advice but you will probably want our products. 


Full specification Econet Interfaces : £39.50 More details available 
Econet Interface with terminator : £ 46.00 in our FREE 
Multi-tasking Teletext Server software : £ 87.00 catalogue : just 
Printer Spooling software for Archimedes : £ 65.00 telephone or write to : 
Printer Server for BBCB/Master Series : £54.00 XOB (dept.BB1) 
Bulletin Board Software for Network Messaging : £ 55.00 Balkeerie, 
Remote Logon Software to share hard discs : £38.00 Eassie, 

Acorn Level 4 Fileserver software : £199.00 Angus, 

Pathway : The easy way to find resources : £44.00 DD8 1SR 
Multi-User Adventure Game (ACK) : £88.00 Tel: 030 784 364 
and 


InterClock : combined Econet clock, interface and 
terminator (the simple and inexpensive way to start 
a new network) : £89.50 


(All prices here are exclusive of VAT and allow for education discounts) 


Minerva's Graphbox Professional 


Reviewed by Bob Cumming 


fundamental requirement for scientists is 

a graph drawing package which can 
produce graphs to the standard required for 
publication in scientific journals and 
presentation at scientific meetings. At the 
other end of the spectrum is the need of 
business users to present data (often financial) 
in an eye-catching manner. Graphbox 
Professional from Minerva (abbreviated 
Graphbox Pro) goes a long way to meet these 
requirements. 


OVERVIEW 

The program is, of course, fully RISC OS 
compliant, occupying about 384K of memory. 
However, because it uses memory 
dynamically for data storage, large volumes of 
data will demand more memory than this. The 
package sets out to display the data in the 
chosen format, with some _ nice 
embellishments to the display being possible; 
but since the image can be saved as a Draw 
file, final modifications can be done by 
importing the graph into other packages. It 
will also accept data in a variety of standard 
formats, and so can be used in conjunction 
with spreadsheets etc. 


Control over the display of the graphs is 
achieved through on-screen menus, but styles 
not accessible in this way can be achieved 
through importing the data as a SID (Software 
Independent Data) file containing the required 
embedded commands. SID files are used by the 
program to save particular configurations of 
graph formats for repeated use with fresh data. 


The package comes in a box together with 
an A5 ring-bound manual some 100 pages 
long. The single disc can be backed up as 
normal. In addition to Graphbox Pro, the disc 
contains two fonts Tabloid.medium and 
Montclair.medium, which require the Font 
Manager version 2.00 or above. 


The manual is very clear, and includes a 
very useful tutorial section taking you 
through the generation of a variety of graphs 
from data on the disc. There are also many 
other data files on the disc to illustrate the 
graph types not mentioned in the tutorial, but 
discussed elsewhere in the manual. The 
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manual even describes the SID file format, 
with many clear examples. 


GETTING STARTED 

After installation, clicking the Menu 
button over the multi-coloured Graphbox Pro 
icon on the icon bar reveals options for info (as 
normal), quitting the application and clearing 
the data. Clicking Select over the icon throws 
up a full-screen Minerva advert reminding 
you what program you are running and 
prompting you for data entry. 


DATA ENTRY 
Data is accepted in a number of formats: 
ASCII files (as produced by Edit, for 
example) 
CSV files (Comma Separated Variables) 
TSV files (Tab Separated Variables) 
SID files (Software Independent Data) 


These will allow compatibility with most 
spreadsheets. Once the data file has been 
generated it is imported into Graphbox Pro by 
dragging the data file onto either the Graphbox 
Pro icon on the icon bar, or to the full screen 
Minerva advert referred to previously. 


An excellent feature is the dynamic 
memory allocation for the data file. The 
program admirably coped with 6 data files of 
some 200 points each, on the same set of axes. 
A very powerful facility is the ability to add 
more data to the end of a data file already in 
graph form, or to add extra sets of data to 
produce graphs with several data sets per 
axes. Both these facilities can easily be 
achieved by dragging the new data file icon 
into a window containing an existing graph 
while pressing the Shift/Ctrl keys. 


TYPES OF GRAPH AVAILABLE 

The package will select a default line 
graph if none has been previously specified in 
the data file as a SID command (a line graph is 
a graph in which only one column of numbers 
is needed; the data is evenly spaced out on the 
X-axis by the package). It thus operates like a 
bar chart or histogram. An X-Y graph is where 
the X-axis is also scaled, and so the data file 
needs two numbers (the co-ordinates) for each 
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point drawn. It is the X-Y graph that is of most 
use to the scientist, of course. In Graphbox 
Pro, a line graph can have both configurations. 
In addition, Graphbox Pro can also generate 
what it calls “Scatter charts”, which are X-Y 
graphs, but with the points unconnected. 


1991 current account 


Figure | Simple line graph for the display of financial 
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data. Note the vertical Y axis 


Once the data is loaded any of forty three 
graph types can be selected from the Graph 
option of the main menu display by pressing 
the Menu button anywhere over the graph. 
The main categories are as follows: 

Bar charts 

Line charts 

Pie Charts 

Kite diagrams 

Stacked area charts 

X-Y plots (points joined) 

Scatter charts (points not joined) 

Polar charts 

Vector plots 

Triangular plots (ternary diagrams) 

Surface plots 

In addition, many of the line, bar and pie 
charts can be displayed in 3D, producing 
some stunning effects. Once loaded, the data 
can be readily displayed in any of the 
alternative graph forms (as appropriate). 


Modifying the appearance of a particular 
graph type is controlled from the Options 
entry of the main menu. Here a window is 
displayed which allows specification of key 
components such as: 

Scales for X and Y and Z axes: Options include 


logarithmic or linear for both X and Y; date and 
time for X axis only. Control over the number of 


intervals and divisions within intervals is 
possible (but not for the Z axis). 


Labels for the axes and title: An excellent 
feature of the package is that up to 2 fonts can 
be mixed in the label, as well as providing the 
facility for having superscripted and subscripted 
text. Thus it is possible to have units properly 
displayed (m3 etc.), and Greek letters. 


Size of data point symbols: A size of 0 entered 
in the size box causes the point symbols to be 
omitted from the graph. A larger number 
proportionally increases the size of the symbols. 


Lines joining points: Curve fitting routines 
available are: best straight line, second and 
third order polynomials, and a Bezier curve 
facility which just joins the points in a smooth 
curve. 

Grid on/off: The grid can be positioned on the 
axes intervals. 


In addition to these basic features on the 
Options menu, there are some nice facilities for 
changing the pattern fill on pie charts or bar 
charts, and for converting the whole screen to 
grey scales or monochrome. When 
monochrome is selected, the lines between 
point are changed from colour to one of a series 
of black dashed lines, making their rendition 
through a monochrome printer excellent. 


An attractive feature for more fancy 
displays is the provision of a graduated fade 
as a backdrop. The bars of bar charts can also 
be shown in terms of multiple symbols 
(pictographs) which have been previously 
constructed in Draw. 


A final feature controllable from the Options 
menu is the legend. The legend (unless turned 
off) is always displayed on the right of a graph 
or chart, and there is a facility for labelling each 
symbol used from this option menu. 


The main menu has a number of other 
useful features: 

Zoom facility: This allows the graph to be 

enlarged or reduced in size. 

Print facility 

Save facility: This provides a number of formats. 

The Draw format is used for the graph. The SID 

format is used for the data and graph format 

together. This can be reloaded into Graphbox Pro. 

The statistics of any curve fit can be stored as a 

text file or as a CSV file; and finally there is a 

Hotlink facility to Colton Software's Pipedream. 
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Edit data facility: This permits the display and 
editing of data currently in the graph package. 
This is well thought out, in that extra columns 
and rows can be added, and data corrected or 
copied. 

Measure: This facility gives the co-ordinates of 
the current pointer position in actual graph co- 
ordinates (numeric, time, polar, etc.). 


OTHER FEATURES 


Some of the parameters used in plotting 
the graph cannot be controlled from the 
Options menu, e.g. the selected font or colours 
used. Such parameters are easily adjusted by 
editing the default parameter file on the disc 
(via Edit). Through the incorporation of 
suitable commands in a data SID file, it is 
possible to manipulate the graph further: to 
turn off the default underlining of the 
heading, for instance, or change the colours of 
the lines or backdrop. 


FUNCTION PLOTTING 

The package allows the plotting of 
functions by importing a file with the function 
written in a Basic format. There is good control 
of the display facilities through options. 


Effect of buffer on response curve 


Figure 2 Example of two X-Y graphs on one set of 
axes with error bars used as 95% confidence limits 


and Greek font in axis title 


EVALUATION OF PACKAGE 


For business graphics | attempted to plot a 
graph found in a newspaper. This is shown in 
figure 1. It was interesting to note that 
Graphbox Pro does not have a facility to draw 
the axes as a box - a style much favoured by 
newspapers it seems - and also the grid 
thickness could not be varied. As a free 
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standing package it is fairly powerful, but 
used in conjunction with Draw (and Draw 
add-ons), excellent results can be obtained. 


For scientific purposes it is a very good 
start. On the plus side, | liked the way it 
handled large data files, allowed mixed fonts 
and the inclusion of real error bars along with 
the data (e.g. it is possible to put 95% 
confidence limits on each point on the graph - 
see figure 2). But on the negative side it needs 
to be able to plot X-Y graphs with two or more 
Y scales (like Cricket Graph on the Mac). Also, 
numeric 3D plotting is desirable, since the 
surface options in Graphbox Pro are not scaled 
correctly, the X-Y data merely being spaced 
evenly along the axes, as in a bar chart 
plotting routine. 


There are a number of smaller packages I 
am aware of for the Arc. An excellent low 
priced contender is the newly released 
Chartwell, from RISC Developments, for 
instance. None of them, in my opinion come 
up to the specification (and also the price) of 
Graphbox Pro. Scientific users might well be 
advised first to evaluate the suite of PD 
programs from Chris Johnson: Chartdraw, 
Graphdraw and Multiplot. The newest 
versions which I have seen provide most of 
what you need for X-Y plotting. 


How does it compare with what is 
available on the PC and Mac’s? In some areas 
it excels. You would probably have to pay at 
least three times the price for such colour 
graphics on a PC; but then such programs as 
the Harvard Graphics/Draw systems can do 
much more - they have to, since they were 
developed before multi-tasking (of sorts) 
became possible on the PC via Windows3. 
Graphbox Pro, although very useful for 
business, could be improved, and with more 
control of the colours from a menu, rather 
than through a SID file. And I think if a little 
bit more attention were to be paid to the need 
of the scientist (an area of increasing Arc 
usage), Graphbox Pro would be perfect. 


As it is, it is the best there is on the 
Archimedes, but you have to pay for it. 


Product GraphBox Professional 

Supplier Minerva Software 
Minerva House, Baring Crescent. 
Exeter EX1 1TL, 
Tel. (0392) 437756 

Price £151.58 inc. VAT AU 
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A File Compare Utility ——— 
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by Ainsley Pereira 


his short utility takes the filenames of 

two files, then checks them byte by byte 
and tells you if they are the same or not. 
This is useful in many cases, for example, if 
you have two Basic programs and you want 
to check if they are the same, or you need to 
know where the differences are. It is also 
useful for checking two text files to see if a 
backup is identical - but remember, the 
utility can be used on any filetypes. 


USING THE PROGRAM 

First, type in and save listing 1 as 
CompSrc. When you run this, it will create a 
utility (filetype &FFC) called Compare in the 
currently selected directory (CSD). To use 
comparison, just type *Compare with the 
correct disc in, or double-click on it from the 
Desktop. You will be prompted to type in 
the two filenames (you can just type the 
names of the files if, they are in the CSD, 
otherwise you must type in the full 
pathnames). After a short pause (the length 
of which depends on the length of the files) 
you will get one of two messages: “Files are 
exactly the same” or “Files are different at 
offset &xxxxxx”, where &xxxxxx is the offset 
from the beginning of the file of the first 
difference. 


HOW IT WORKS 

The two files are opened using OS_Find 
&4F. The handles are stored in locations 
Filel_Hand and File2_Hand. One byte is read 
from each file using OS_BGet, and the bytes 
are then compared. If the two bytes are 
different, the program prints the ‘Files are 
different’ message and ends. If they are the 
same then the next is read and checked. R4 
is used to keep track of how far into the file 
the check has progressed: this counter is 
only used if the files are different, in which 
case it is printed out in the error message. 


The check continues until the end of one 
file is reached. If it is also the end of the 
other file, then the files are the same, 
otherwise the files are of a different length 


and have to be different. Before finishing the 


program closes both files. 
10 REM >CompSrc 
20 REM Program File Compare Utility 
30 REM Version A1.0 
40 REM Author A.M. Pereira 


50 REM RISC User March 1992 
60 REM Program Subject to Copyright 
70 REM Not Public Domain 


$0 DIM Code §192 
100 FOR pass=4 TO 7 STEP 3 


110 P%=0:0%=Code 
120 [OPT pass 
230 : 


140 .Compare_Files 

150 STMED R13!,{RO-R12,Ri4} 
160 ADR RO,Filenamel_mess 
170 SWI *xOS_Writed* 

180 ADR RO,Filenamel_buff 
190 MOV Ri,464 

200 MOV R2,#33 

MOV R32, #255 

SWI *XOS_ReadLine* 
ADR RO,Filename2_mess 
SWI "XOS_Writet" 

RO, Filename2_bufi 
MOV R1, #64 

280 MOV R2,#33 

290 MOV R3, #255 

300 SWI “*XOS_ReadLine* 


Qoooao eo 


Nth & & NR KF ND 
IO & tw fh Pe 
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320 MOV RO, #&4F 

330 ADR Ri, Filenamei_butt 
340 SWI *XOS_Find* 

350 BVS Opening_error 


370 STR RO,Filel_Hanc 


name2_buff 


I *x0S_Find* 
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460 MOV R4,20 990 EQUB 0:ALIGN 

470: 1000 : 

480 .Compare_lcop 1010 .Filename2_mess 

490 ADD R4,24,41 1020 EQUS "Enter second filename : * 
500 LOR Ri, Filel_Hand 1030 EQUB 0:ALIGN 

510 SWI °XOS_BGet® 1040 : 

520 BCS EndOfFilei 1050 .Filenamel_buff 

530 MOV R2,R0 1060 EQUS STRINGS (64,CHRSO) 

540 : 1070 ALIGN 

580 LDR R1,File2_Hand 1080 : 

560 SWI *XOS_BGet* 1090 .Filename2_buff 

570 BCS EndOfFile2 1100 EQUS STRINGS (64,CHRS$O) 

580 CMP R2,R0 1110 ALIGN 

590 BNE Difference 1120 : 

600 B Compare_loop 1130 .Filel_Hand 

610 : 1140 EQUD 0 

620 .EndOfFilel 1150: 

630 LDR R1,File2_Kand 1160 .File2_Hand 

640 SWI "XOS_BGet* 1170 EQUD 0 

650 BCC Difference 1180 : 

660 B Ail_Clear 1190 .All_Clear_mess 

670 : 1200 EQUS *Files are exactly the same." 
680 .EndOfFile2 1210 EQUB 0:ALIGN 

690 LDR R1,Filel_Hand 1220 : 

700 SWI "XOS_BGec* 1230 .diff_off_buff_adr 

710 BCC Difference 1240 ADR R1,diff_off_buft 

720 : 1250 MOV PC,R14 

730 .All_Clear 1260 .Difference_mess 

740 ADR RO,All_Clear_mess 1270 EQUS *Files are different at offse 
750 SWI *XOS_Writed* t &° 

760 : 1280 .diff_off_buff EQUS STRINGS (8,CHRS 
770 .Finish_Off 0) 

780 ADR RO, newline 1290 EQUB 0:ALIGN 

790 SWI *XOS_Writed* 1300 .newline 

800 MOV RO, 40 1310 BQUD &00000A0D 

810 LDR Ri, Filel_Hand 1320 : 

€20 SWI *XOS_Find* 1330 .Opening_error 

830 LDR Ri, File2_Hand 1340 MOV RO, #0 

840 SWI *XOS_Find* 1350 MOV R1,#0 

850 LDMFD R13!, ({RO-RiZ,R15} 1360 SWI *XOS_Find* 

860 ; 1370 ADR RO,OpenError_mess 

870 .Difference 1380 SWI *xXOS_Writed* 

880 MOV RO,R4 1390 LOMFD R13!,{RO-R12,R15) 

890 SUB RO,RO, #1 1400 : 

$00 BL diff_off_buff_adr 1410 .OpenError_mess 

910 MOV R2,#7 1420 EQUS “Error opening file for input 
$20 SWI *xXOS_ConvertHexé* Pie 

$30 ADR RO,Difference_mess 1430 EQUB 0:ALIGN 

540 SWI *XCS_Writed* 1440 : 

$50 B Finish off 1450 ] 

960: 1460 NEXT 

370 .Filenamel_mess 1470 SYS "OS_File*,10, Compare’, &FFC,,C 
980 EQUS "Enter first filename ;: * ode, Code+P¢ 


AU 
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by Lee Calcraft 


L ast month we gave the full listing for an 
application which gave an animated 
display within a small window on the 
Desktop. I had hoped this month to animate 
a sprite within this window, but problems 
with flicker make this unviable at present. 
Instead I will concentrate on reducing the 
flicker in last month’s display. 


The key to the problem lies in how the 
window is updated. Unfortunately, you 
cannot just print to the screen when writing 
Desktop programs, because there may be 
windows from other applications which 
partially, or even completely, 
obscure your window. The 
most usual way of forcibly 
refreshing a screen, and that 
adopted in last month's 
program, is to find the co- 
ordinates of the area to be 
refreshed, and then pass this 
information to the Wimp by 
calling SYS “Wimp_ForeRedraw”. 
In due course the Wimp will 
send a Redraw reason code to 
our task (providing that the 
Wimp needs help with this 
job), and the task must then 
respond using a standard redraw loop in 
which the task repeatedly redraws those 
rectangles which the Wimp nominates as 


needing to be redrawn. 


As is clear, this is rather an involved 
process, and is not best suited to fast 
animation! A better approach is to use SYS 
“Wimp_UpdateWindow”. This allows the 
task to engage upon the window-updating 
loop immediately, rather than after a round 
of Wimp polls. An even greater advantage of 
this approach is that the ihe does not clear 
the area to be refreshed, which is what it 
normally does when SYS “Wimp_ForceRedraw” 
is used. 


As you may imagine, clearing the 
window area is a major cause of flicker, 
since it takes time, and because there must 
necessarily be a relatively long time delay 
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Desktop animation 


after the area is cleared before redrawing 
starts. The viewer thus has time to see the 
object he is looking at - the ball in our case - 
disappear before it is redrawn at the new 
position. 


By using SYS “Wimp_UpdateWindow”, 
we avoid this, but we must obviously add 
some code to remove the previous image of 
the ball before we draw the ball in its new 
position, or it will leave a trail. This is all 
achieved with a new version of PROCforce. 
Instead of calling SYS “Wimp_ForceRedraw”, 
this performs the whole redrawing action 
itself. The new line at the 
start of the definition stores 
a copy of the last used x and 
y co-ordinates of the ball, 
and this is later used to 


> draw over the old ball in the 
& 


background colour. 
5) 3 Animator) 

There is one thing to 
note with this approach: you 
now effectively have two 
redraw mechanisms - the 
instant update mechanism 
which responds to null 
reason codes, and moves the 
ball on to its next position as described, and 
the original one used when the Wimp needs 
to redraw any part of our window. This 
must obviously be left in place, and must 
use the same algorithm for displaying the 
ball as is used in PROCforce - except that it 
does not need to erase the old position of 
the ball, since the Wimp will have cleared the 
window anyway. 


If you replace the old version of 
PROCforce with the new one (note that only 
the first line, and a dozen or so lines at the 
end of the procedure have been changed) 
you should see the improvement. 


You may also like to experiment with the 
WAIT statement. This halts execution of the 
program until the end of the next VDU 
raster scan, and will reduce the chances of 
the program changing the contents of 
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A Desktop Animator 
display RAM during a raster scan - another. 


cause of flicker. The best place to insert a 
WAIT is immediately before the first of the 
two CIRCLE FILL statements in PROCforce. 
It will slow down the action a bit, but may 
reduce flicker. If you place a WAIT 
immediately before the second CIRCLE 
FILL, it will create terrible flicker because 
although it reduces the raster scan problem, 
it inevitably means that the time between 
erasing the old ball and displaying the new 


one is considerably lengthened. 


2000 DEF PROCforce 

2010 oldxXt=xt:oldy%=v$ 
2020 X$+=38:YS+=k$ 

2030 IF X%>180 THEN 

2040 j%=-A8S(3$) 

2050 IF 3% THEN PROCblip 
2060 ELSE 

2070 IF X&<20 THEN 

2080 7$=ABS(j$) 

2090 IF j% THEN PROCblip 
2100 ENDIF 

2110 ENDIF 

2120 IF Y%>180 THEN 

2130 kt=-ABS(k&) 

2140 IF k& THEN PROCblip 


1390 WHEN obj%=2:PROCrename(leaf$+*.*+n 
ames) 

1400 WHEN nameS=*Outlines® :out=TRUE 

1410 ENDCASE 

1420 ENDIF 

1430 UNTIL nextt=-1 

1440 IF out? THEN 

1450 aS=pathnameS+leaf$+*.* 

1460 x8=LENoldfont$:y%=LENnewfont$ 

1470 file$=OPENUP(a$+"IntMetrics*) 

1480 BPUT#£ile$, newfont$+leaf$+STRINGS ( 
x¥-y$,CHRS13); 

1490 CLOSE€file® 

1500 SYS *OS_File*,16,a$+"Outlines*,mem 
%,0 TO.,,,,2en% 

1510 ptré=mem$-1: lent+=mems 

1520 REPEAT ptr$+=1 

1530 UNTIL. FNmatch(oldfont$) 

1540 difft=4*((y#-x&) DIV 4-(((y#-x?) M 
OD 4)<>0)) 

1550 IF y$>x% THEN 

1560 FOR jt=lent+diff$ TO ptré+diffe st 
EP -difft 
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2150 ELSE 

2160 IF Y&<20 THEN 

2170 =k %=ABS(k3) 

2180 IF k® THEN PROCblip 

2190 ENDIF 

2200 ENDIF 

2210 IF RND(100)>80 THEN j$+=1 

2220 IF RND(100)>80 THEN k$-=1 

2230 !blockt=windowt 

2240 SYS *Wimp_GetWindowInfo*, ,block$ 
2250 smaxt=block$!20+block$!12-block&!4 
2260 ymaxt=block?!24+block$!8-block$!16 
2270 block$!4=block®!20:block$! B=ymaxt 
2280 blockt!1Z=xmax%:block$!16=plock$!2 
P ; 

2290 SYS "Wimp_UpdateWindow*, , block’ TO 
more’ 

2300 PROCgetorigin(blockt,x0%,y0$) 
2310 WHILE more$ 

2320 SYS *Wimp_SetColour",1 

2330 CIRCLE FILL x0t+oldxt, y0$-oldyé, 


2340 SYS *Wimp_SetColour",11 

2350 CIRCLE FILL x08+X%,y0$-Y%, 20 

2360 SYS “Wimp_GetRectangle",, block’ 
TO more’ 

2370 ENDWHILE 

2380 ENDPROC RU 


Font Name Conflicts (continued from page 21) 


1570 !j%=3%!-dif£$:NEXT: lent+=diffs 
1580 FOR it=16 TO 48 STEP 4 

1590 mem$!i$+=cif£$:NEXT 

1600 ENDIF 

1610 bS=newfont$+leaf$+CHRS0+"Outlines" 
1620 $ptr$=bS:ptr’?LENb$=0 

1630 SYS "OS_File*,10,aS+*Outlines*, &FF 
6, ment, lent 

1640 ENDIF 

2650 ENDPROC 

1660 : 

1670 DEFFNmatch(x$) 

1680 LOCAL i$:REPEAT it-=1 

1690 UNTIL ptr8? (it-2)<>ASCMIDS$(x$,i%,1 
} OR i%=LENx$ 

1700 IF i$=LENx$:=TRUE 

1710 ptré+=i%-1:=FALSE 

1720 : 

1730 DEFPROCreport (a$} 

1740 !block$=1:$ (plock$+4) =a$+CHRSO 
1750 SYS “Wimp_ReportError",block’,1, °F 
ontName" 

2760 ENDPROC AU 
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THE COUNTDOWN CONTINUES ; 


Karma - the largest and most detailed space and life simulation for home 
computers - is now available in its introductory form, the Flight Trainer. This is 
the first in a series of releases, and launches recruits into a realistic space 
experience in charge of a large interstellar vehicle - the Mothership. 


Karma has been designed to the highest specifications including... 


Full Newtonian implementation of laws of gravity and motion 


Over 8000 unique celestial bodies in 335 solar systems 


Over 6000 orbiting, faceted, 3D, artificial objects 

Object shading appropriate to closest stellar light sources 
3D dynamic Star Charts —_ 

Over 50 Mission Stages 


64 bit 3D model 


“At last there is a product 
which truly harnesses the power 
of the Archimedes." 


Dr. Jan Miasik B.Sc., M.Sc., Ph.D. 


Please enrol me in your Galactic Flight }. The Flight Trainer imb 
Training programme. Release 2.00 2mb 

Release 3.00 2mb 
Name 


Address Periscope Software Limited 


302 Wedon Way, Bygrave, Baldock, Herts. 
SG7 5DX. 


Postcode Tel. (0462) 893107 Fax (0462) 490088 


| enclose a cheque/postal order for £25.99 
which includes post and packing (please add 


£3 for overseas orders) made payable to 0) 
Periscope Software Ltd, Please allow 28 days <ARMA 


for delivery. 


Into the Arc 


Using Shared Resources 


by Mike Williams 


he Archimedes, like any modern 

computer, is a sophisticated system. All 
the components of your Archimedes are 
managed for you by RISC OS, the 
Archimedes’ operating system, and you 
interact with RISC OS via the Desktop using 
the mouse and its associated buttons. 
Running applications (programs) on your 
Archimedes will often involve the use of 
additional software resources such as 
System Resources, Printer Drivers and 
Fonts. For efficiency, these resources are 
normally shared by all of the applications 
which you might use, but for this to work 
properly you do need to know a little about 
these resources and how best to set them up 
on your system. That is what this article in 
our Into the Arc series for beginners is all 
about. 


Some resources are supplied with every 
Archimedes, some are supplied with 
relevant applications, and some may need to 
be purchased in their own right. All these 
resources are really no more than programs, 
which can be installed on your system, and 
shared by other applications which need 
them. 


How best to install such resources may 
also depend on the configuration you are 
using (floppy disc only, hard disc or 
network) and whether you are using RISC 
OS 2 or the latest RISC OS 3 (currently only 
available as part of the A5000 system). 


SYSTEM RESOURCES 

You may already have encountered the 
message “System resources cannot be 
found”. This message refers to a special 
application (!System) which is supplied on 
one of the Applications discs which comes 
with your Archimedes. If you have a hard 
disc then !System may already have been 
installed in its root directory. 


Locate your copy of !System (by opening 
the directory display for the relevant disc), 
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and then double-click on the !System icon 
while holding down the Shift key. This will 
open the !System directory which should 
contain files with names like !Boot, !Run, 
!Sprites and a further directory called 
Modules. Double-click on this directory to 
open its display - it should contain files with 
names like CLib, Colours and FPEmulator. 
Don’t worry if not all of these are present, or 
if others are there. These files are all modules, 
self-contained programs providing specific 
functions for your Archimedes. Any and all 
of these modules will be loaded 
automatically by any applications which 
require them, and are referred to as System 
Resources. 


Whether you are using RISC OS 2 or 
RISC OS 3, a number of modules are 
supplied in ROM ready to use. The 
difference between the two, in this respect, 
is that RISC OS 3 has room for many more 
modules than RISC OS 2, including the three 
referred to above (CLib, Colours, 
FPEmulator). You can check which ROM 
modules are in your system by pressing F12 
(to exit from the Desktop) and then entering: 

ROMModules 
and pressing Return (use Shift to scroll the 
screen if necessary). Press Return a second 
time after the display is complete to return 
to the Desktop. ROM-based modules need 
only a small amount of RAM as workspace 
(if that), whereas those loaded from !System 
need RAM for the code as well. 


If you are using a floppy disc system 
(with no hard disc or Econet connection) 
you should keep a copy of !System in the 
root directory ($ directory) of a separate 
floppy disc (or your current work disc). 
Label that disc as System Resources or similar. 
Whenever you first switch on you 
Archimedes, it is sensible to insert this disc 
into drive 0, and click on the drive icon to 
open its directory display. Once this has 
been done, RISC OS knows on which disc 
!System is located. You will often come 
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across references (in RISC User for example) 
about !System being ‘seen’. That is what 
opening the directory display containing 
{System achieves. 


If you are using a hard disc, then 
!System should be installed in the root 
directory of your hard disc. Opening the 
root directory of your hard disc will 
similarly ensure that !System is ‘seen’. The 
advantage of a hard disc is that !System is 
always accessible, whereas floppy disc users 
may find themselves instructed to re-insert 
their System Resources disc from time to 
time. 


If you are using a network, then !System 
can be installed on the network file server, 
but it may prove better (quicker) to have 
your own copy on floppy or hard disc as 
appropriate. Consult your network manager 
for advice. 


A word of warning is not out of place 
here. A good many users (particularly those 
without a hard disc) end up with different 
copies of !System on different discs. This is 
bad practice which easily causes more work 
and adds confusion. Try to keep just one 
main working copy of !System. The reasons 
for this will become clearer, I hope, as we 
proceed. 


CLIB 

Now let's take a look at one of the most 
commonly used shared resources, CLib. 
This is the shared C library containing 
routines needed by any compiled C 
programs (in a list of modules its name will 
appear as SharedCLibrary). C is a 
programming language often used for major 
applications, two examples being Draw and 
Edit supplied with your system. Other 
examples are Ovation and DeskEdit from 
RISC Developments. 


When such an application is run, it will 
first check that the required version of CLib 
is already loaded into memory or is 
available in ROM. If it cannot be found, it 
uses RISC OS's knowledge of where !System 
is located to load the module, again 
checking that it is the correct version. If 
!System has not been ‘seen’, then this is 


when you get the message “System 
resources not found”. 


UPDATING !SYSTEM 

Sometimes you may get a different 
message along the lines of “CLib version 
3.75 or later needed”. What has happened is 
this. Over the years, some modules like 
CLib, have been developed and extended. 
More recent applications are dependent 
upon using a later (maybe the latest) copy of 
CLib than was originally supplied with your 
system. In these cases you will usually find 
that the disc containing the application 
comes with a further copy of !System with a 
Modules directory containing the latest 
version of the required module. In effect, 
you need to replace the original copy of the 
module in your working copy of !System by 
the later copy supplied on disc. This can be 
done by opening the two Modules 
directories and dragging the new version to 
your working copy. 


There is, however, a simpler way of 
achieving this by using the more recent 
Sysmerge application included with !System 
on the disc containing the application. 
Simply double-click on SysMerge, and then 
as prompted drag first the old (master 
version) of !System to the SysMerge 
window, and then the new version of 
!System. All modules as appropriate will 
then be updated to the latest versions. 


Although modules may be supplied in 
ROM (e.g. CLib under RISC OS 3), this does 
not prevent later versions from being added 
as and when they are released. The new 
version is simply stored in the Modules 
directory of !System as described above. 
Any application which must use that later 
version will ensure that the disc-based 
version is loaded and used in preference to 
the older, ROM-based one. 


You may now begin to appreciate the 
confusion which can arise if you have more 
than one working copy of !System, with 
maybe different versions of the same 
module(s). One trick worth knowing, if you 
do get into a mess, is that double-clicking on 
a particular !System will ensure that that is 
the one known to RISC OS, and not any 
other version of !System seen earlier. 


RISC User March 1992 


OTHER SYSTEM RESOURCES 


There are a number of other modules 
which you might encounter and which are 
stored within !System. One is the floating 
point emulator known as FPEmulator. Most 
processors, and the ARM processor is no 
exception, are designed to perform integer 
arithmetic only. However, the machine code 
instruction set is usually extended to 
contain additional instructions which will 
perform arithmetic on fractional (real or 
floating point) numbers. The floating point 
emulator provides’ a software 
implementation of floating point arithmetic, 
which is needed by some applications. 
However, it also allows Acorn (or third 
party vendors) to provide a hardware 
floating point unit to do the same job (but 
much more quickly). The A5000, for 
example, is designed to accommodate a 
floating point accelerator from Acorn, due 
out in the first half of this year. 


Other modules are generally less 
common. Colours (or ColourTrans as it 
appears in a modules list) is used by some 
applications to ensure that colours will 
appear as near the same as possible 
irrespective of what mode is in use at the 
time. Thus an application can specify a 
palette colour it wishes to use, and 
ColourTrans will determine the nearest 
colour in the currently selected mode. The 
details are unimportant to most users, but 
the module enables applications to work 
more effectively in different modes. 


MsgTrans is a module used by 
applications which are designed to operate 
in more than one language. It is not 
supplied as part of RISC OS 2, but is 
included as standard with RISC OS 3. 
Otherwise you are only likely to find it 
supplied with those applications which 
specifically need it. 


By keeping all text strings separate from 
the application proper, different language 
versions can be easily produced, with 
MsgTrans ensuring that each text reference 
results in the corresponding text string. If 
you explore RISC OS 3, you will find many 
examples of message files (just have a look 
inside the application directories for Edit or 
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Draw). Other modules which you might 
come across include MemAlloc and 
WimpUtils 


TEMPORARY FILES 

In the past, ‘System has also provided an 
additional function, as a home for 
temporary files. To see what scrap file (if 
any) is in use on your system, press F12 and 
type: 

Show WimpSScrap 
(press Return again to get back to the 
Desktop). 


The need for a scrap file most often 
arises when a file is dragged from one 
application to another, and an intermediate, 
temporary location is required to store the 
data. Printer drivers also use separate 
‘scrap’ files when working in the 
background. Acorn has recently changed its 
policy and introduced a_ separate 
application !Scrap. This is again supplied 
with RISC OS 3, but third party applications 
will also include this in future when 
needed. 


On a hard disc system, !Scrap should be 
stored like !System in the root directory. If 
you are using floppy discs only, then a copy 
of !Scrap should be included in the root 
directory of every floppy which contains an 
application. By this means, references to 
System are kept to a minimum, as once any 
system resources have been loaded they are 
accessible and usable by any other 
application. Keeping !Scrap with an 
application means that when that 
application needs temporary file storage it 
can be located on the same disc that 
contains the application itself, thereby 
avoiding unnecessary disc swapping, the 
bane of all floppy users (note: you should 
run !Scrap before loading the application). 


For a more detailed and technical 
exposition of Acorn’s latest guidelines on 
the use of !Scrap refer to the article on this 
subject by David Spencer in this issue. 


Next month we'll take a look at Fonts 
and Printer Drivers, two further examples of 
shared resources, and see how we can best 
make them work for us. 
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Karma - The Flight Trainer — 


Robin Watts reviews this epic space game 
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fter more than 18 months of waiting, 

the most talked about game in the 
Acorn world has finally arrived. Karma is 
here - or at least its flight trainer is. With 
over four years development behind it, one 
almost dares not call it a game - indeed 
Periscope Software refer to it as a ‘Virtual 
Reality’. 


Release 2 of the game (available 
sometime later this year) will add the much 
vaunted “Life Model”, a much more 
detailed simulation of the solar system. With 
it you should be able to follow other ships 
around, and communicate with them, 
gaining insights that may help you in your 
quest. Release 3 (somewhere around nine 
discs) should follow shortly after this, 
giving access to a full 2400 star systems. 


Karma is a hard game to describe. The 
most obvious parallel is Elite, in that both 
games involve flying from place to place in 
a galaxy, but Karma is fundamentally 
different. Apparently the universe has 
started to contract, so various pilots are 
being sent out to distant galaxies to search 
for a new planet or planets to house the 
human race. You play the role of one of 
these pilots, currently going through 
training in a simulator. 


In the simulator your training consists of 
a series of missions, each of which requires 
you to find an example of a specific natural 
phenomenon, and to locate objects in orbit 
around it. Once found, these objects give 
you your next mission objective, and so on. 
There are over 50 missions to complete and 
after playing solidly for about a week, I 
have only reached mission 9. 


About half way through these missions, 
you are directed to a star to pick up your so- 
called “hopper ship”. This is a much smaller 
craft than the mothership you normally 
pilot, and can be transported around inside 


it. Its main use is for short range hops 
between planets and satellites. The hopper 
is launched by a “Star Trek” type 
transporter, and the effect as the hopper 
fades in from nothingness is really effective. 


In contrast to Elite, the universe is 
properly 3-dimensional, in the shape of a 
spiral galaxy. Each solar system in this 
galaxy contains numerous planets with 
satellites (both natural and man made) that 
can be examined with sensors, and in some 
cases communicated with. The whole galaxy 
has been generated from a model, so that 
the distribution of star types and sizes is 
astronomically correct. 


It is here that we start to get a glimpse of 
the effort that has been put into this game - 
the planets rotate around the stars, the 
satellites rotate around the planets, all the 
time spinning on their own axes. Detailed 
physical and chemical breakdowns of the 
make up of any celestial body are given on 
request, from the core temperature of suns 
to the chemical composition of the ice on the 
surface of the planets. 


There is a down side to all this 
technological wonder though. Whereas Elite 
was simple enough for a seven year old to 
play quite happily, Karma has enough 
complexity to take it beyond the capabilities 
of some adults. For a start, all the movement 
in the game is modelled with proper 
physical momentum and acceleration. If the 
ship thrusts momentarily in one direction it 
will continue to move in that direction for 
ever, until such time as another force is 
applied, or it runs into a planet. 


This all means that flying around in the 
same way 4s in Elite is right out; U-turns are 
an impossibility and even managing to halt 
the craft is a major achievement. All this 
gets much more worrying when you realise 
there is no hyperspace facility. All flight 
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between solar systems is done by pointing 
yourself in the general direction of the 
destination star and thrusting, repeatedly 
stopping and re-aligning yourself to avoid 
errors. 


Your ship has three drives fitted to cope 
with the huge differences in scale of the 
distances between stars and planets. The 
primary drive is used to move light years 
across space at speeds far exceeding that of 
light, the secondary drive is used within 
solar systems for flitting between planets 
and satellites, and the manoeuvring drive 
is used to fine tune your speed, down to 
centimetres per second. The hopper, 
however, is only equipped with the two 
slower drives. 


To simplify life a bit, Periscope 
Software has included an autopilot in the 
mothership. The only drawback with it is 
that it is abysmally stupid. As far as it’s 
concerned nothing else exists except the 
start and end points of the route, so if it 
drives you through a planet half way, too 
bad. In practice though, this is not such a 
problem, and as long as you make sure 
you are not going to hit anything at the start 
point of the jump, you will normally be all 
right. 


The game’s graphics are very well done. 
The starfield actually reflects the position of 
other stars around you. Objects are drawn 
differently as well, with their facets being 
shaded according to the inclination to the 
sun, which makes them look startlingly real, 
as opposed to the slightly “cartoon like” 
look of Elite. Nicest of all though is the 
Galactic Map page, where a three 
dimensional view of the entire galaxy is 
given that can be moved, rotated and 
zoomed in real time. 


The game is controlled by a combination 
of mouse and keyboard. The mouse is used 
to select targets from the scanner, map or 
screen and to flip between the different 
system screens. The keyboard on the other 
hand is used primarily to manoeuvre the 
ship during manual flight, though function 
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key shortcuts are supplied to access the 
more commonly used systems screens. 


All this may seem far too complex to 
handle, but the excellent game manual 
simplifies learning a lot. Not only does it 
introduce the functions of the mothership, it 
also has sections on physics, astronomy and 
the natural environment designed to 
familiarise the user with the language and 
concepts used in the game. 


ORT: WORLD IBEATI 
INGICATE THAT THIS IS A GAS PLANET 


The Hopper Craft 


The flight trainer comes on two discs, 
and will install on a hard disc if required. 
When run, the game installs on the icon bar, 
and clicking the icon has the effect of 
entering the simulator. Pressing Escape at 
any time returns you to the Desktop, where 
the game position can be saved. 


In conclusion, if you want an all-action 
game then perhaps this release is not for 
you, but if on the other hand you want a 
game that will keep you riveted to your 
computer for hours, stretch it to its limits, 
and have the promise of even greater things 
to come, then Karma is a must. It already 
outclasses any other game on the Arc. Roll 
on the full version! 


Product 
Supplier 


Karma - The Flight Trainer 
Periscope Software 

302 Wedon Way. 
Bygrave, Baldock, 

Herts SG7 5DX 

Tel. (0462) 893107 

Price £25.99 inc. VAT and p&p 
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e2 
iles are different at ‘aise t 8888848 


Press SPACE or click mouse to continue 


A handy utility to compare the contents of two 
files and report on any differences. 


A useful application which allows you to 
change the name of a font throughout the 
definition files. 


The example 
application given 
this month 
implements RAM 
transfer of data 
from one 
application to 

| another. 


The new Scrap application from Acorn. This is 
the new method of using scrap files, and should 
be installed on all Archimedes computers. 


during a file save operation. 


This month the 
animation 
display is made 
considerably 
smoother using 
the new 
techniques 
described in the 
article. 


An example of how to implement RAM transfer 


TATE STR 


RIC ica) a, 
| econ io 


A very powerful and highly sophisticated multi- 
tasking card index database, which is extremely 
easy to use. Informer offers a number of 
powerful features: user definable layout with a 
lot of editing facilities (including search and 
replace), a highly sophisticated sorting facility 
(records can be sorted on any field in ascending 
or descending order), records can be searched 
for any 'marked' field and with user specified 


logic, etc. - too many features to name. 


BL adfss:RU w8si8$.$ 
"Risclser !fininator !futoPlay —!Conpare 
: | cm i 


CDeno !Fontifane {Index —_!InFotod 


LInformer Scrap Screens! Security 


a 0 fm # 


ISpeedTest !Spinel !Systen _‘!Tunes 


4727 40383 " 


Please enter Security Coder[_ 
TF YOU'RE BUYING THIS COMPUTER, AND THE VENDOR 
DOESN'T RAVE THE CODE, IT HAS BEEM STOLEN!! 


This application will make your computer 


identify itself on power up, and will refuse to A handy 

allow any applications to open windows until application 

you have keyed in your password. This is only that installs 

relevant for those users with hard discs. on the icon 
bar and Startcodes 
gives Initialise: 


SIV ; _ Finalise: 
information Service: 


on modules 
dragged to it (e.g. name, version number and 
important addresses). 


fun sdts: Mardbise.$.Rldiscs, 504, 'Speedlest Files basic. speedtest 
Basic arithnetic on the fire 


10008 Empty took tin 

Leas Fett der sitions took 7! centi-sees 
oteger multiplications took 71 centi-secs 
gteaer divisions took 84 centi-sees 


ip 
ducks = 


(R008 Real additi i- 
se pee Real ions took 85 centi-secs 


A number of programs in Basic, C and Pascal for 
testing the speed of the various languages. 


A selection of screendumps from the Rombo 
Vidi-Archimedes digitiser, reviewed in this 
issue. 


A game loosely based on Asteroids, which 
includes smooth graphics and options to collect 
money and buy more equipment for your ship. 


The complete 
application as well 
as the two Maestro 
tunes repeated 
from last month. 


ArcScan indexes for this issue of RISC User and 
BEEBUG Vol.10 No.8. 


Pictographs in Ovation and 


Impression 


Mike McNamara explains how Ovation and Impression can be used to produce 
the same picture-based graph effects as PipeDream 4. 


| na recent RISC User article (Volume 5 Issue 

2) readers were introduced to the new 
release from Colton Software - PipeDream 4. 
One of the newer features offered in this 
package is an in-built graphics facility. This 
enables the user to take data from a 
spreadsheet section and display it in graphical 
format. Within this Colton has included the 
ability to produce Pictographs - graphs where 
the number of items in a given category is 
represented by a corresponding number of 
appropriate images (those penguins again) 
in place of the more conventional column or 
line. This can, when used with care, produce 
a most dramatic and eye catching effect (see 
figure 1). As I don’t have PipeDream 4, and 
am not likely to be able to afford it (but am 
interested in using this effect), I got thinking 
how I might duplicate it in some other 
package. 


PICTOGRAPHS IN DTP 

My first thought was to use Draw, and 
indeed this package will do the job very 
well. However, such a graph would 
generally form part of a larger work, 
including much text, and Draw is just too 
inflexible. I therefore turned to Ovation, and 
then Impression, and would like to share 
with other readers my solution. If you use 
Impression then skip the next few sections. 


OVATION: STEP ONE 
Creating pictographs with Ovation is 
comparatively straightforward. Should you 
need to relocate the finished graph at some 
later stage in the creation of the overall 
document it is important to begin by 
creating a ‘parent’ text frame on your page. 
ALL subsequent elements of the graph will 
then be created within this frame. With 
‘ Ovation’s use of frame families this will 


Figure 1. Typical pictograph 


singe unit by simply moving this outermost 
parent frame. 


STEP TWO 

Having created your parent frame you 
should now create a graphics frame sized to 
suit the repeated image you intend to use 
for the graph. In my example (figure 1) I 
have opted for a lcm (10mm) square. Into 
this frame you should then import the 
selected image. This can of course be any 
image in a compatible format for Ovation; I 
have used a Draw file. 


Locate this frame in the position of the 
bottom element of the first column of your 
proposed graph. 


STEP THREE 
You are now ready to start the real 
building process. 


Making sure that your graphic frame is 


ensure that the graph can be moved as a active, move to the ‘Object’ option in the 
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main Ovation menu, and then into 
‘Duplicate Frame ...’. 


Set the ‘Vertical Offset:’ to 0 and the 
‘Horizontal Offset:’ to a size equal to your 
graphic frame width (10mm in my 
example). Finally, set ‘Number of Times:’ to 
1 less than the number of columns needed 
for your graph. The first column is made by 
your initial graphic frame. 


You should now have the bottom row of 
your developing graph. However, you may 
well find that the graphics are taking a fair 
amount of time to re-draw. If this is the case 
then select the ‘Hide Pictures’ option from 
the ‘View’ menu. 


STEP FOUR 

The next stage is to build up each column 
to its required height. The procedure is 
basically the same as in the last stage - select 
the graphic frame at the bottom of the column 
and then use ‘Duplicate Frame:’ - except that 
the ‘Horizontal Offset:’ is set to 0 and the 
‘Vertical Offset:’ is set to minus the height of 
your graphic element frame. In my example 
this means setting the vertical offset to -10. If 
you forget the minus sign the elements will 
be copied down, not up. 


STEP FIVE 

To produce the axis lines for your graph 
simply use the Line tool from the Ovation 
Tools menu. However, to ensure that the 
lines are horizontal and vertical, hold down 
Shift while dragging out the lines. 


STEP SIX 

Finally, you can place any axis labels, 
heading and/or other comments simply by 
creating text frames as required (all within 
the main graph frame). If necessary, select 
‘Show pictures’ from the ‘View’ menu to see 
the graphics correctly displayed. 


PICTOGRAPHS IN IMPRESSION 

As with the technique explained for 
Ovation, the process of producing a 
pictograph in Impression is based on the 


RISC User March 1992 


Pictographs in Ovation and Impression 


creation of the first picture element for the 
graph, followed by its repeated duplication. 
However, Impression does not support the 
automated ‘Duplicate Frame’ facility of 
Ovation so the process leaves you with a 
little more work to do. 


STEP ONE 

Create a new frame on the page, sized to 
match the graph you want to produce. This 
frame is going to provide the X and Y axes 
of your graph. 


Once the frame has been created, select 
‘Frame’, ‘Alter Frame’ and ‘View’. On the 
resulting ‘Borders’ menu set the left and 
bottom sides of the frame to 1. If you 
temporarily hide guides you should find a 
perfect set of graph axis. 


STEP TWO 

In order to make this and the following 
stages simpler, I would then recommend 
that you set Impression to ‘Show Rulers’ so 
that you can use these to help with 
subsequent alignment. 


Now create another new frame of a size 
suited to the graphic to be used for the 
graph. As before I have opted for a lcm 
square. Here again, the ‘Alter Frame’ menu 
will help, as through it you can set the 
height and width of the frame exactly. 


Once the frame is the correct size, and in 
the correct position (first item of first 
column) import your selected graphic, scale 
and/or locate as required and then select 
‘Misc’, ‘Hide Graphics’ to speed things up 
once you start duplicating. 


STEP THREE 
Click on the graphic element just created 
to ensure that it is the active frame. From the 
menu select ‘Frame’ and ‘Snap to frames’. 
Now select ‘Edit’ and ‘Copy frame’ followed 
by ‘Edit’ and ‘Paste frame’. Note that if you 
use the Adjust key in place of the Select key 
on the mouse on all but the last of these 
options they can all be selected without the 
menu being closed and reopened repeatedly. 
Continued on page 48 
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Base Base5 DBMS v2.00 


BaseS DBMS is a suite of BASIC V functions and procedures designed 
to implement database programs. Now upgraded to v2.00, it remains 
fully compatible with RiscBASIC and ABC compilers. 


® Fully compatible with RISC OS, with Wimp Interface support 

® User configurable 

@ Extensive search features 

@ Multiple databases in use simultaneously with easy communication between them 

@ Rigorous in-built error checking and Command History 

® Comprehensive documentation of tutorial material, language reference and file format 
@ Extensive import and export features 

@ A separate library of mathematical and calendar functions 

® A fully multi-tasking database application !Base5 as a get-you-started entry point 

® Flexible and easy to use Report Designer/Generator 


PairData 


First of an increasing number of fully compatible products for use with BaseS DBMS. 
@ A BASIC V library for the creation and processing of coordinate pair data 
@ !Mouseln, a fully multi-tasking utility to write pointer coordinates directly into databases 
® Centre of Gravity, mean distances, nearest and furthest point calculations ete. 


AdMaths +#% NEW *** 


A library of advanced mathematical and statistical routines fully compatible with all existing 
Base5 products. 

® Skewness, Pearsonian and Kurtosis indexes 

@ Median, Mode, Quartiles and Trimeans, Geometric, Harmonic and Quadratic means 

@ 3 non-linear Least Squares best fit 

@ Harmonic curve fit by Fourier analysis 

® Student ¢ and Chi Squared tests 

@ Fully programmable graphics routines for Pie, Bar, Line, Scatter, etc, diagrams 

® Export of graphs as Sprites or Draw files for easy inclusion in DTP 

@ Separate library for any BASIC program to export graphically as Sprites or Draw files 


Base5 BaseS DBMS = £69.00 

P.O. Box 378 Demo Disc £5.00 refundable on purchase of full system 
WOKING PairData £22.50 (£18.00 to Registered Users) 
Surrey GU21 4DF AdMaths £25.00 (£20.00 to Registered Users) 


Great Britain No VAT 


Exploring UNIX on the Arc 


Part 2: Using Xwindows 


by Lee Calcraft 


on the Arc, concentrating on the command 

ne interface. But RISC iX is also supplied 

with a graphical user interface - the so-called 

Xwindows suite of software - and we will now 
take a look at this. 


LOGGING ON 


To get into the Xwindows system on RISC 
iX you can either log on to RISC iX as usual, 
and then enter the command startx, or you 
can log on to RISC iX as x. The former is 
probably easier, since it takes you straight into 
Xwindows - providing that you have a multi- 
sync monitor configured, otherwise you get a 
blank screen, and the system appears to hang. 


ast month we looked at the use of UNIX 
L 


Xwindows starts up on on the fb+kbd 
device (this is one of the four virtual 
terminals which RISC iX can support 
simultaneously). It does this irrespective of 
the device from which you issued the 
original command. This still leaves you two 
further virtual devices from which to access 
UNIX via the command line, permitting you 
to flip between desktop and command line - 
and since all virtual terminals multi-task, 
this is a very powerful feature. 


MWM ORTWM ? 


When you first access Xwindows, a 
dialogue box appears which asks you whether 
you want the Mwm or the Twm window 
manager. The manuals do not really prepare 
you for this decision, and if you click on help 
you are unhelpfully informed that “you are 
being asked to choose between the Mwm or 
the Twm window managers”! 


In fact these two alternative window 
managers provided with the RISC iX package 
control the look and shape of the windows, 
and the behaviour of the window icons and 
menus. Both offer similar functionality, but the 
Motif window manager (Mwm) is crafted in 
3D, and although it looks very pretty, it is 
almost impossible to use with less than 8M 
bytes of RAM. 


The problem is that, since UNIX uses virtual 
memory (i.e. part of the hard disc is used as an 


extension of available RAM), there is massive 
disc activity whenever you so much as breathe. 
Windows take input focus as you move the 
pointer across them, and this is denoted by a 
fancy 3D cyan border. Unfortunately it can take 
up to half a minute to put it there even with an 
ARM 3. So moving the pointer across the 
desktop - let alone actually trying to move a 
window - can take an age. 
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Figure |, RISC ix Xwindows using the 3D Motif 
(Mwm) window manager 


The unfussy 2D MIT window manager 
Twm does not suffer from this problem, and is 
the only viable route for 4 Mbyte users. It even 
allows you to move windows in real time. 
Having said this however, you soon run into 
the same difficulties if you try to put more 
than a couple of applications on the desktop at 
the same time. 


As you might guess, the differences 
between the two window managers go deeper 
than mere appearances. For example the 
window controls operate in different ways. 
Mwm has three control icons on its window 
title bars, while Twm has just two. But both 
allow you to close or resize a window, or to 
iconise it in the manner of the RISC OS 3 
Desktop. Windows can be moved by dragging 
their title bar, but placing a window to the 
bottom of the stack can only be done via the 
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Exploring UNIX on the Arc 


window menu. For speed, and convenience 
the Arc’s window manager has both Mwm 
and Twm well beaten. 


1 Sqpuvew Cock 


J Round Cock 


Figure 2. RISC iX Xwindows using the 2D MIT (Twm) 


42 


window manager 


THE SESSION MANAGER 


Whichever manager you are using, your 
Xwindows session will be controlled by a 
session management shell called Xsm, and 
this provides a simple environment for 
users to multi-task so-called Xclient 
programs on the desktop. It also provides a 
simple mechanism for automatically 
starting up chosen clients when the user 
logs on. Xsm puts up a control window at 
the bottom right of the screen when it starts 
up. See figures 1 and 2 for the Motif and 
MIT versions of this. 


The handy Save option on this window 
saves the state of the desktop (including 
which window manger is in force, and 
which applications are running) for auto- 
booting next time you log on to X. Clicking 
on the Clients entry on the other hand, 
brings up a list of client programs. The default 
clients include three terminals, a clock and 
calculator, a full screen editor called Xedit, a 
manual browser, and something called 
X.desktop. 


X.desktop 

In spite of its name, X.desktop is really 
only a filer application for Xwindows. In fact 
X.desktop is marketed as a stand-alone 
software package costing some £500, so Arc 
users are getting a good bargain (though they 
only get version 2, rather than version 3). To 
make use of X. desktop, you can click on its 


button icon within the Xserver Client 
window. This brings up a directory display of 
the root directory within a standard window. 
Files and directories are displayed as 
somewhat large icons (64x64 pixels) - though 
there is a procedure for changing their default 
size. 


Different icons are used to represent 
different types of object - an ordinary 
directory looks like a paper wallet, while the 
root is depicted by a filing cabinet, and the 
home directory by a single filing drawer. Text 
documents are depicted by sheaves of paper, 
while executables use a computer and monitor 
icon. A nice feature is that the access state of 
each file - so important on a multi-user system 
such as UNIX - is displayed graphically. 
Documents which the user may read but not 
write to are overlaid by a pair of spectacles, 
while directories which are locked against 
access, and executables which may not be run 
are overlaid by a padlock 


Figure 3. Using the X.desktop filer 


Opening directories and running 
executables is performed in the usual manner 
by double-clicking on the corresponding 
object Similarly, copying is achieved by 
dragging. Apart from the normal window 
menu, X.windows provides two further 
menus: the Desktop menu and the Directory 
menu. These are both brought up by pressing 
the Menu button of the mouse at different 
places on the screen, and offer a variety of 
useful options including detailed file info, 
ways of changing the filer display - including 
sorting the objects - and running other 
applications. 
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An interesting feature of X.desktop is that 
in keeping with the style of other UNIX 
software, its behaviour is highly 
configurable. It uses special sets of editable 
files called resource files and rule files which 
determine not only its appearance on the 
screen, but also the effect of particular mouse 
clicks (the mapping between mouse button 
events and so-called triggers within the 
system), and even what happens when you 
drag an icon to another icon or to a directory. 
Rule files are particularly powerful, allowing 
nested structures which take on the 
appearance of structured C source code. 


One reason for providing such flexibility 
is to allow the user to configure his filer to 
match the appearance and behaviour of 
other systems with which he may be 
familiar. Another is the extreme flexibility 
that it gives the user. He could for example 
configure the X.desktop filer to invoke a text 
editor when compiler files were dragged to its 
icon, and compile such files when they were 
double-clicked. These kind of things are also 
possible in RISC OS of course, but are 
achieved in an entirely different way. 


Xedit 

This is one of the better UNIX text editors, 
and in fact I am using it to write this article - 
though it will need to be imported back into a 
more powerful Archimedes text editor (you 
know the one) to tidy it up, format it and add 
printer codes. 


Xedit is really very limited if you are 
trying to use it for any kind of word 
processing task. It does have a useful Search 
and Replace feature and an undocumented 
Marked Copy, but you can only move around 
your document one character at a time 
(apparently), and while it will wordwrap as 
you type, it only does so under the most 
simple circumstances. It fails if you have text 
ahead of the cursor, and it cannot format after 
a delete. So if you edit a paragraph of text in 
any way, you must edit all succeeding lines to 
the required length by hand. 


There is also no interactive control over 
text width, though this is probably 
configurable before you invoke the editor - 
and - as you may gather - there is no 
documentation beyond a page in the on-line 
manuals. However, saving files is wonderfully 
easy - just click on Save. 
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Figure 4. The useful Manual Browser in action 


THE MANUAL BROWSER 

This useful application allows you to 
browse UNIX’s on line manuals. The Manual 
Browser has two pull-down menus: Options 
and Sections. The first provides a number of 
useful features including an option to display 
an index (called a Directory) of the currently 
selected section, a keyword search, and a new 
window option. The second displays a list of 
sections as follows: 

1. User Commands 

2. System calls 

3. Subroutines 

4. Devices 

5. File formats 

6. Games 

7. Miscellaneous 

8. Sys.Administration 


Each entry contains considerable detail, 
giving reasonably full information on each of 
the parameters used with the command in 
question, known bugs etc. Some 400 commands 
are documented in this way alone. However, 
when it comes to documentation on complete 
software packages available on the system, the 
on-line manual is rarely detailed enough. 


To conclude, the Xwindows graphical user 
interface provides a most acceptable 
alternative way of accessing and running 
UNIX programs, though for best results you 
will need an 8 Mbyte machine. The ability to 
flip between desktop and command line 
terminals offers amazing power. Acorn has 
done well to bundle Xwindows in with their 
UNIX package for such a reasonable cost. /=)/)) 
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Disc 7 - Chess Program for The Archimedes. 

A Chess program that takes full advantage of RISC OS, installing itself on the icon 
bar and running on the desktop in a window. You can work with other programs 
whilst you play Chess. Many features, computer play, hint, save games, edit etc. 
Risc User July 1991 said: "Chess is an absolute bargain. .playing at a comparable 
level it always beat Micro Power's offering. ...this has to be the one to go for’. 


Disc 8 - CrossStar 2.XX Crossword puzzle solver 

Fully RISC OS compliant desktop Crossword puzzle solver. 200,000 word 
dictionary. Solves interlocking clues. Editable/user definable dictionaries. Saves 
grids as Draw files. Browse through dictionary. Cleck grid for new words. Save 
clues as text file. 


Disc 16 - Spark RISC OS Archive program 

Spark, allows you to store files and directories in archive files in a very 
compressed form. e.g. sprites often take up only 10% of normal space. Files in 
archives, can be accessed just like files on disc. Now new Spark series 2.XX, has 
lots more features. Reads all these formats, zoo, zip, Izh, UNIX and Archie Tar, 
Compress. Reads and writes PKarc, SEA/PC arc, uucode, atob/CET+, FCET. 


Disc 19 - StarChart. Star maps. 

Program that uses a database of 9000 stars etc. to produce star maps. Also 
calculates the positions of the planets and shows them on the maps. Star maps 
are in the form of Draw files and can be imported into !Draw, Ovation etc. 


Disc 32 - Charm. High level language and environment. 

Charm, is a high level language similar to Pascal and C. This implementation, 
includes a compiler, linker and assembler, with an editor, and a desktop 
environment to use them. The Charm system is both fast and ideally suited to 
being used on 1Mbyte and floppy machines. Demos with source, Chinese 
checkers and an arcade style game. An easy way to produce ARM code programs. 


Disc 33 - Panorama. Your window on the World! 

180,000 coordinates outlining the lakes, rivers, continents, state boundaries etc. of 
the World and a program that can produce Draw files from them. You can make 
maps of any part of the world and then use them in DTP etc. programs. Includes 
the positions of nearly 1000 cities. Does simple, cylinder, Mercator and perspective 
projections. Can be used from a single floppy disc and requires no setting up. 


Disc 35 - Trace. Banish those jaggy blues! 

Takes Sprites and turns them into Draw files. Works with full colour Sprites. Sprite 
format pictures are plentiful, but if you try to scale them, they develop jagged 
edges. Trace allows you to convert them into Draw files which can be made any 
size you want. You can now use the powerful tools in Draw on Sprites. Now with 
D2Font program for turning Draw files into fonts. Make your own fonts from sprites. 


Discs are £5.99 each, all inclusive. Buy four claim one free! 


David Pilling, P.O. Box 22, Thornton Cleveleys, Blackpool. FY5 1LR. 


Free Air Mail delivery on overseas orders. Extensive range of other Archimedes software 
available (programmers tools, games, utilities, clip art), please send for free list. 


Security 


Computer anti-theft protection by Kell Gatherer 


These applications are only available on this 
month's magazine disc. 


arlier this year | heard tell of a man who 

took a computer into a second hand shop 
to try to sell it. The shop assistant plugged it 
in to make sure it worked - and was presented 
with a screen saying that the machine had 
been stolen! The police were called and the 
computer was restored to its rightful owner. 


The Security application on this month’s 
magazine disc is intended to have the same 
effect. To be effective, such a program must be 
permanently resident in the machine, so its 
usefulness is restricted to computers with an 
internal hard disc. 


Informer 


When the machine is first switched on and 
the hard disc is accessed there appears an 
uncloseable window with details of the 
rightful owner, telephone number, computer 
serial number etc. Any attempt to run another 
application will generate an error until the 
correct password is entered, after which the 
computer behaves as normal until next 
switched on, 


Security is a straightforward piece of 
programming, but the statistics show that the 
kind of person that steals a computer will 
probably not know how to switch it on, never 
mind unlock a locked file and delete it. So this 
simple application could bring your computer 
back from theft, making it almost invaluable. 


AU 


A Full Feature Database by Robert Armes 


nformer is a very sophisticated multi-tasking 
| based database, yet it is extremely easy 
to use. Card layout is user definable, and data 
fields on the cards can be any of integer, string, 
real, date, telephone number or currency. When 
a card is being designed, the layout is dealt 
with automatically - you 
simply need to enter the 
name of each field and its 


type. 


When the card has been 
designed, data is simply 
entered by typing informa- 
tion into writable icons. New 
records can easily be added, 
using a window with self- 
explanatory icons. The 
application is a delight to use, 
and it is totally RISC OS compliant, so getting to 
grips with the system is incredibly easy. However, 
under this external simplicity lie a number of very 
powerful features. 


<r 
=a ~ 
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Fields can be left, right and centre justified; 
there is an autosave option to ensure your data 
is saved regularly; cards can be found very 
quickly, either by number or by matching a 
specific field; there is a very comprehensive 
printing facility, allowing specifically marked 
records to be printed; there 
is a very useful search and 
replace facility; records can 
be searched for and 
“marked” (thus allowing 
only those records found to 
be printed), the search being 
carried out on specific fields 
and with user specified 
logic; there is a highly 
sophisticated sorting facility 
enabling records to be sorted 
on any field in ascending or 
descending order; basically there are too many 
features to be named, but it is safe to say this is 
one of the best applications we have ever put 
on a magazine disc. 

‘ RU 


45 


WP/DTP 


Exploring Impression II 


Paul Vigay investigates some of the newer and perhaps overlooked features of 
Impression Il. 


ince Impression I was launched, many for logos that you may want to recur at a 
uggestions for improvement have been fixed position on every page. One feature of 
made. Most of these new ideas have been repeating frames is that they only start from 
added in Impression II, in addition to whichever page you initially create them on. 
numerous fairly minor alterations. Some of You could create a repeating frame on page 
the changes are quite insignificant and are three of a ten page document and it would 
merely of cosmetic value, whereas some are start on page three and continue to page ten, 
extensive and well worthwhile. but not appear on pages one and two. Once 
created, you can restrict the repetition of 


GROUPING AND REPEATING FRAMES repeating frames by deleting any occurrence 
Probably one of the most significant of it. It will then remove any occurrence 
changes is that of being able to link together after that point. For example, to remove 
multiple frames, and either group them as repeating frames from page six onwards, 
one or position them as a selected group. delete the frame on page six. 
The best way to illustrate this is to open a 
new document and create a couple of new 
frames. 


Now highlight one by clicking Select in 
it. To select the other frame 
simultaneously, just click Select on it as 
normal, but also hold down the Shift key. 


7 rane 1¢ 
i Edit 9 Alter frame... “Ful 
You will now see that both frames are | ffet ¢ [" '"™ . 


highlighted. They can now be dragged png ee 
around and positioned as one. When you 


are building up tables of figures, or just 


complicated designs made from more than Force te nert 

one frame, you may find it helpful to Seas te tec 

group multiple frames as one, rather like 

Draw can group objects together. To do Impression II's frame menu 


this, mark each frame by highlighting it 
while holding down Shift. Then use 
Impression’s Frame menu to select Group 
Frames. This will then group them all as one 
frame. If, at a later date, you wish to 
ungroup them, you can simply select 
Ungroup from the same menu. 


To enable you to create repeating frames, 
a new option has been added from the New 
Frame option on the Frame menu. If you 
want, you can also press Shift-Ctrl-R as a 
key shortcut to create a repeating frame. 


RULERS 
Another addition to the frame system is A number of changes to the style ruler 
the facility to create ‘repeating frames’. This have been made to simplify its use. It is now 
allows you to create a standard frame which locked onto the edge of the frame so that the 
can then be duplicated on each page of your tricky alignment by hand is no longer 
document - ideal for headers and footers, or necessary. There are now two ways to edit 
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the ruler. Firstly, by bringing it up as part of 
the style editor, which is similar to that used 
in Impression I. However, a second way of 
editing it has been added in Impression IL, if 
you use the Edit ruler or New ruler options. 
The New ruler option now allows you to 
alter the ruler without bringing up the style 
menu. This means that you can create tables 
and indents without the need to choose a 
new style. Again the ruler will lock itself to 
the current frame, automatically aligning 
itself with any new frames selected. 


a 1 TT | 
Sa (| 


The Preferences dialogue box 


Rulers edited by themselves must 
define every attribute such as left and right 
margins and any new tab positions, as 
settings from previous rulers will not show 
through in the same way as styles do. A 
ruler set-up box has been added so that 
you can specifically enter numerical 
values for each of the ruler attributes. This 
allows you to enter exact measurements 
for fine adjustment. 


BORDERS AND EFFECTS 

A new Effects menu has been added, 
which lets you alter minor style changes 
without the need to create a brand new 
style. This allows you to select things such as 
line spacing, left and right alignments, 
underline, and subscript from a single menu. 


Another new effect is the facility to 
define your own frame borders. These can 
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now be created using Draw, and then 
simply dropped onto the Border set-up 
dialogue box. Using Draw you only need to 
create the left-hand edge of the border. 
Impression II can then rotate this Draw file 
to complete the rest of the border. The edge 
of the frame is aligned with the right-hand 
edge of the backmost object, and then 
stretched so that it exactly fits the edge of 
the frame. 


PREFERENCES 


A number of new preferences have been 
added which allow you to inform 
Impression of various global options that 
you would like set automatically on 
loading. These include whether the page 
borders are shown, whether the caret is 
flashing or not, and an enhanced graphics 
option which has been added to Impression 
II. This gives Impression II the ability to 
rotate sprites within frames simply by 
dragging the mouse around the frame. 
With an ARM3 fitted this happens almost 
in real time. However, in order to use this 
option, a 2 Mbyte machine is 
recommended. 


t= oe 


Document preferences 


Printing has also been extended to cater 
for draft printing which allows you to use 
your printer’s standard text mode. This 
allows you to print text without the need to 
load a RISC OS printer driver. The print 
dialogue box has been simplified with the 
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Ltn itedd: Edit style 
Pratt + 
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Simplified font menu 


addition of a Print setup menu which lets 
you select some of the less used printer 
options such as ignoring page borders, 
reflecting pages for typeset film and printing 
pamphlets. There is a new 2nd half option 
which allows you to start the printing of 
pamphlets from the second side of the paper. 


Once ‘Paste frame’ has been selected you 
will be presented with the cross guides. 
Move these to the top right corner of the 
graphic frame already in place. With the 
‘Snap to frame’ option ‘on’ you should find 
this very easy and accurate. 


Paste (or *V) can then be used 
repeatedly for all the elements of the bottom 
row of your graph. 


STEP FOUR 

To build each column of the graph, 
simply continue to use the Paste option. 
However, to gain maximum help from the 
‘Snap to frame’ facility, I have found it best 
to construct the highest column first and to 
do so at 200% view. 


This column will require a little careful 
adjustment of the horizontal position of each 
new unit as at this stage ‘Snap to frame’ only 
acts horizontally. Once this column is in 
place however, the snapping effect works in 
both directions making the remaining 
columns very much easier. 


A key shortcut has been added to allow 
you to reset the print dialogue options to 
their default settings by pressing Ctrl-Print. 


Page numbers can now start from zero if 
you require, and Show print borders will now 
accurately portray all borders, taking into 
account any settings within the print 
dialogue box. 


CONCLUSIONS 

Although 2 Mbytes of memory is 
recommended to gain full use from your 
DTP system, some superb results can be 
obtained even when only armed with 1 
Mbyte. With practice you should be able to 
create complex and elaborate documents 
with the minimum of fuss and effort. 


We welcome articles, hints and tips on DTP for 
publication in our WP/DTP column. All items 
published are paid for. RYU 


Pictographs in Ovation and Impression (continued from page 39) 


STEP FIVE 

As with Ovation, you can then place any 
graph titles, labels, keys, etc. simply by 
creating frames as required. 


STEP SIX 

In Ovation, the use of ‘frame families’ 
was employed to keep all the elements of 
the graph together as a unit. In Impression 
this system is not used. In its place 
Computer Concepts has employed a ‘Frame 
grouping’ option very similar to that used 
by Draw. 


To use this you need to hold down Shift 
and click on each frame within your graph 
in turn. As you do so, each will be selected 
but without the usual control handles. Once 
you have them all selected move to the 
menu and select ‘Frame’ and then ‘Group 
frames’. This should, after a short delay, give 
you one single composite frame enabling the 
graph as a whole to be moved, resized, etc. 


as required. 
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Quick on the Draw 


Alan Wrigley looks at three products which aim to create Draw files from sprites 


idnight Graphics’ Tracer, which 

translates sprites into Draw files, has 
been on the market for a while now. It has 
recently been joined by two other 
applications purporting to achieve the same 
objective: Trace from David Pilling and 
Image Outliner from Iota Software. This 
review will look at all three and see how 
well they achieve their aim. 


WHY DRAW FILES? 

First of all, why convert sprites into 
Draw files? After all, most document 
processors cope quite happily with either; 
even Draw itself can import sprites (though 
it retains them as such and does not convert 
them to Draw objects). The answer is very 
straightforward - the resolution of a sprite is 
fixed at the size at which it was created, 
whereas a Draw object, being vector based, 
can be scaled within a wide range without 
resolution being lost. For DTP work in 
particular, where the image has to fit the 
space rather than vice versa, this is a very 
important consideration. 


Sprite-based clip art is very plentiful, 
much of it originating from digitised 
images. You might also want to scan your 
own images or drawings or grab 
screenshots for use ina DTP document. So a 
method of converting an image to a Draw 
file could be very useful in a number of 
situations. 


It has to be said at the outset that no 
software can possibly know for certain 
whether a particular line of pixels is 
intended to represent a path, especially if it 
is broken in places. So the degree of success 
depends on the nature of the sprite as well 
as the algorithm used. Rather than be critical 
of the software for not doing the job 
perfectly under all conditions, we should 
perhaps be amazed that it does it at all. 
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GENERAL CONSIDERATIONS 

Before looking at the applications 
individually, it is worth considering in 
general terms the kind of images which can 
be converted successfully. As you might 
expect, simple bold lines work best, so the 
cartoon-style pictures which are widely 
available in clip-art collections are usually 
good candidates for a successful conversion, 
though thin angled or curved lines do not 
always work so well. At the other end of the 
scale, a complex sprite which attempts to 
represent a multitude of colours by 
dithering will usually give poor results 
when converted. Between these two 
extremes the results will depend on the 
interaction between the application and the 
sprite, but bear in mind that you can do a lot 
to tidy up the image in Paint before 
conversion, and again in Draw afterwards. 


TRACE 

David Pilling’s Trace is delightfully 
simple to use. Clicking on the icon opens 
two windows, labelled Sprite and Draw; 
dragging a sprite to the application displays 
it in the sprite window. A simple menu 
offers the option to create a Draw file, while 
a Choices option enables you to choose the 
average error for each pixel traced. This 
provides a trade-off between the accuracy of 
the trace, and the time taken and size of 
Draw file produced. Small values will create 
a Draw file which will more closely 
correspond to the sprite, but if you make the 
value too small Trace will start to reproduce 
individual pixels, which clearly defeats the 
whole object of the exercise. Once the 
conversion is finished, a menu option allows 
you to save the Draw file. 


Trace does not multi-task while 
converting, and the process can take quite 
some time. Even with an ARM3 in my 
machine most traces took several minutes 
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and I found myself tapping the desk 
impatiently. Depending on the kind of 
image being traced, however, the result was 
often worth the wait. Varying the error 
setting often made a considerable difference 
to the final image. 


Trace will convert colour images quite 
happily (though 256-colour sprites are 
converted as monochrome). As mentioned 
earlier, sprites with dithering or complex 
areas of colour are likely to give poor 
results. Simple images with large blocks of 
colour work best. 


TRACER 

Midnight Graphics’ Tracer operates in a 
similar way to Trace - clicking on the icon 
bar icon or dragging a sprite opens two 
windows, with the sprite displayed in one. 
In this case, however, a few more options are 
provided. Tracer will not trace colour sprites 
automatically, so you can choose to treat the 
sprite as monochrome. You can also alter the 
grey-level cut-off point - in other words the 
level at which the Draw file will show black 
instead of white. A further dialogue box 
allows you to alter parameters such as the 
pixel sampling rate, the minimum distance 
between control points and the smoothness 
of curves. A Clean option attempts to 
rationalise areas of multiple tones to smooth 
out the effects of dithering. 


The process is semi-multi-tasking, in that 
control is returned to the Wimp after each 
pass (every couple of seconds or so). 
However, the process is also very fast, with 
the Draw file completed in seconds rather 
than minutes. The optimum settings seemed 
mostly to be near the limits of the range, and 
altering them did not affect the result to the 
same degree as with Trace. 


Coloured sprites must be traced 
manually, which involves selecting each 
individual area of colour in turn with the 
mouse, whereupon that section will be 
converted. Needless to say, on anything other 
than a very simple sprite this is almost 


impossible to do accurately, particularly for 
thin lines of one colour against another. The 
application was designed primarily with 
monochrome images in mind, since for most 
DTP work that will be all that users will 
require. Only the 16 standard Wimp colours 
are supported, so 256-colour sprites will be 
represented in 16 colours regardless of mode. 


IMAGE OUTLINER 

Of the three applications considered 
here, Image Outliner is certainly the most 
professional, both in appearance and in its 
approach to the task. For a start, the 
conversion process, though even more 
lengthy than Trace, is fully multi-tasking so 
you can happily get on with other work 
while it is beavering away in the 
background. Furthermore, while Trace and 
Tracer can only handle one sprite at a time, 
with Outliner you can open as many 
windows as memory will allow, and all the 
conversions can operate simultaneously. 


The facilities available are more 
comprehensive too. It is possible (though 
not in the version I reviewed) to read a 
sprite image in directly from a scanner as 
well as input a sprite file. Once a sprite is 
loaded, it can be cleaned in the same way as 
described above for Tracer. This appears to 
give more effective results than Tracer and 
works in colour too. A number of settings 
can be altered which determine the accuracy 
of lines and curves. The conversion process 
can be done in two stages if required - 
before creating the final Draw file, you can 
display and edit the path points in the object 
by deleting them, altering their nature or 
creating new points, so a fair degree of 
control is possible over the finished result 
without needing to load it into Draw 
afterwards. I found this facility very easy 
and intuitive to use, particularly since the 
image can be magnified to ease the process. 


Colour is well supported; unlike the 
other two applications, Outliner handles 
256-colour sprites correctly and produces a 
256-colour Draw file. 
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RESULTS straight lines and curves, many of them just 
I used a variety of different sprites to test one pixel thick. Converting the picture as a 


the applications, and the figures on this page monochrome image with Tracer produced 


show five of these. The 
first two are typical of 
many images you might 
want to trace, consisting 
of bold lines forming a 
stark black-and-white 
image. The woodcut-style 
head was rendered 
correctly by all three 
packages. The REME 
crest was done very 
accurately by Tracer in a 


bold lines which did not 
really do justice to the 
original. Manual con- 
version as a colour 
image fared better, and 
with a little persistence it 
was possible to produce 
an acceptable result. 
Trace produced a fairly 
accurate picture but with 
rather jagged edges. 
Outliner produced much 
smoother lines, as it did 
consistently in all the 


few seconds, and even more 
accurately by Outliner in about 
half an hour (to be fair, this 
length of time was unusual). 
Trace failed here, taking 15 
minutes to render the image as 
nothing more than a solid 
black shape. With Santa’s head, 
however, Trace outshone the 
others, coping very effectively with the detail 
on the horseshoe. Playing around with the 
settings in Outliner produced a result almost 
as good, but with slightly less detail and only 
after another long wait. Tracer on the other 
hand did the job in a few seconds, with all the 
elements of the picture there but with 
considerably less fine detail. 


tests. On the jumbo, this 
resulted in a smoother 
fuselage and much more 
accurate engine hous- 
ings, and by carefully 
manipulating the set- 
tings I could get a result 
which was extremely 
close to the original. 


Finally, the ploughing 
scene was a real test, 
consisting of a mass of 


The other two images were both in curves and large areas of dithering. It would 
colour. The jumbo jet was a combination of have been impossible to trace this manually 
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with Tracer, so I treated it as a monochrome 
image. Even so, it did not produce what I 
considered to be an acceptable picture. The 
other two applications were able to handle it 
in colour. Trace made a valiant attempt and 
got quite close to the original, though the 
edges between one colour and another were 
not very smooth. The star performer here 
was Outliner, which produced a very 
accurate rendering of the sprite, though at 
the expense of a huge Draw file (250K to 
Trace’s 169K). However, using the Clean 
option reduced the size to 78K and 
produced a very attractive, almost 
impressionistic result. 


CONCLUSIONS 


Any one of these applications will 
produce a good result from the right kind of 
sprite, as indeed my tests (and the samples 
supplied with Trace and Tracer) showed. 
Tracer has a huge speed advantage over the 
others but is less able to cope with complex 


sprites. Trace is amazingly inexpensive but 
does not multi-task while tracing. Image 
Outliner has the best facilities, and with its 
editing capability and comprehensive 
accuracy settings, together with a very good 
algorithm, it produces the best results by far 
from more complicated originals. 


Product Tracer 
Supplier Midnight Graphics 
5 Victoria Lane, Whitefield, 
Manchester M25 6AL 
tel. 061-766 8423 
Price £61.25 inc. VAT 
Product Trace 
Supplier David Pilling 
PO Box 22, Thornton Cleveleys, 
Blackpool FY5 1LR 
Price £5.99 inclusive 
Product Image Outliner 
Supplier lota Software 
St John's Innovation Centre, 
Cowley Road, Cambridge CB4 4WS 
tel. (0223) 421542 re 
Price £92.82 inc. VAT AU 


"rin S&S Tt. 
ADVANCED STATISTICAL SYSTEM 


Is the ESTABLISHED Statistics Package for the Acorn Archimedes 
It is widely used in Research, Physical and Life Sciences, Medicine, Industry, Business and 


Education 


‘FIRSTJR' is designed to appeal particularly to the Education Sector 


Providing an impressive selection of statistical techniques it includes FIRST's powerful 
data handling, interfacing and display facilities and on-line manual 


Our new product 


"FIRST JR" 


is now available 


FIRST JR offers a remarkable performance/price ratio at its cost of £49 
Previous ads. in RU contain some details on FIRST 
For full technical and pricing information on the latest version of FIRST and FIRST JR 


contact: 


Serious Statistical Software, Lynwood, Benty Heath Lane, 
Willaston, South Wirral L64 1SD. 


5Z 


Tel. 051 327 4268. 
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Using ANSI C 


Part 8: RAM Transfer 


by Lee Caicraft 


T* routine introduced last month for 
saving files using a standard save as 
dialogue box lacked just one essential 
feature: it did not update the program’s 
copy of the filename. To achieve this, simply 
insert the following statement immediately 
before the last line in the definition of 
save_proc(): 

if (xfersend_file_is_safe()) 

strcpy (save_name, filename) ; 


As you will probably have guessed, this 
only updates the program’s copy of the 
filename after a “safe” save. Thus for 
example, if you drag the icon in the save box 
to Edit, it will be loaded into Edit, but since 
this does not constitute a safe save, no 
updating of the filename will take place. On 
the other hand, if you drag the icon to a 
Filer window, the file will be permanently 
saved, and the name used for future saves 
will be updated. 


The useful function xfersend_file_is_safe() 
handles all this for us, simply returning 
TRUE or FALSE on the basis of the kind of 
save performed. If this code was used in an 
editor, then the value returned by this 
function would also be used to determine 
whether the editor’s title bar should be 
updated with the new name, and also 
whether an asterisk used in the title bar to 
indicate a changed file should be removed 
or not. 


RAM TRANSFERS 

As you may recall, the whole process of 
saving files on the Desktop is set up using 
the saveas() function. We called this in our 
Demo program, supplying the name of the 
function to be used for saving by file 
transfer. Since we did not supply a function 
name for RAM transfers, file transfers will 
be used instead should the need arise. In 
other words, if we drag the icon from our 
save box to another application rather than 
to a Filer window, RISC_OSLib will save our 
data to a temporary file (typically 
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<Wimp$Scrap>), then inform the receiving 
application that it should load this file. 


A more efficient approach is to provide a 
routine for handling RAM transfers directly. 
This way, no disc access is used, and for 
floppy users, this can save a great deal of 
effort, since they would otherwise need to 
follow prompts to change discs, should 
<Wimp$Scrap> not happen to be on their 
current disc. 


A PRACTICAL RAM SAVE ROUTINE 
As always, the best way to illustrate how 
to go about this is to work through a 
practical example. This involves writing an 
equivalent routine to that used in 
save_proc(). Suppose we call this send_proc(). 
To inform saveas() about our new routine, 
we will need to replace our call to this 
function with something along the lines of: 
saveas (Oxfff,save_name, strlen (text_file)\ 
,save_proc, send_proc,0,0}; 


The function send_proc() has the 
following prototype: 

send_proc(void *handle,int max_buff); 
As before, the handle passed is that 
specified in saveas(), and we have specified a 
NULL handle since we have no additional 
data which we need to pass to our routine. 
The second parameter, max_buff, is the 
maximum size of the buffer specified by the 
receiving application (since it is the latter 
which provides the block of RAM used for 
the transfer). 


The function send_proc() merely has to 
place the data which it wants to save into the 
buffer, and inform the receiving application 
that it has done so. If the buffer is not big 
enough, the buffer is filled repeatedly until 
all the data has been passed. The following 
function achieves this: 


BOOL send_proc(void *handle,int *max_buff) 
{ 
char *data_ptr=text_file; 
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int remaining=strlen(text_file); 
int send_ien; 


while (remaining) 
{ 
send_len=(remaining> *max_bduff) \ 
? *max_buff : remaining; 


if (!xfersend_sendbuf (data_ptr, \ 
send_len)} return FALSE; 


data_ptr+=send_len; 
remaining-=send_len; 


The variable remaining holds the number 
of bytes still to be saved (initially set to the 
length of the text file), and the while loop is 
executed while bytes remain to be sent. The 
function xfersend_sendbuf() which does all 
the work takes two parameters: the pointer 
to the start of the block to be sent (data_ptr), 
and the length of data to be sent (send_len). 


This latter is either equal to the total 
number of bytes remaining, or to the size of 
the receiver’s buffer - whichever is the 
smaller (established in the first line of the 
loop). The last two lines within the loop 
update data_ptr and send_len respectively 
according to the number of bytes sent. 


In a real application you will need to 
alter the first two lines of the function to 
establish the pointer to the data to be saved, 
and its length. Normally you would not be 
able to use the function strlen() to obtain the 
data length. Similarly, you would need to 
alter the third parameter used in the call to 
saveas(). Again this should reflect the actual 
length of your data - though this value need 
only be approximate. 


RELEASE 4 ENHANCEMENTS 

If you are using ANSI C Release 4, you 
will notice that a number of new functions 
have been included in the xfersend file. I will 
mention two here. The function 
xfersend_clear_unknowns() can be used to 
clear unknown event handlers set up by the 
likes of xfersend_sendbuf(). The latter 


function adds an unknown event handler so 
that it can receive messages from the 
receiving task. In the normal course of 
events this is removed when the function 
terminates, but under certain conditions 
(and particularly when a transmission error 
occurs) the event processor can be left in 
place. The new function xfersend_clear_unknowns() 
should be called when it is known that a 
transfer has ended. In our example it should 
be called immediately prior to both exits to 
the function send_proc(). 


The new function xfersend_pipe() is also 
of considerable interest. It facilitates the 
transfer of data between tasks without the 
need for an icon drag. This might typically 
be used by a spreadsheet and a graphics 
package so that graphical displays could be 
generated by the automatic exportation of 
data from the spreadsheet. The function 
takes a similar set of parameters to the 
saveas() function with the addition of a task 
handle - this being the handle of the task to 
which data is to be sent. 


Next month we will take a look at error 
handling, u 


DeskEdit FOR C USERS 


Special new features in ver 1.2 


DeskEdit contains many special features for 
handling C source including: 


C function browser Ctrl-F for Next defn 
Ctrl-Sh-F for prev definition 

C syntax checker as you type 

Automatic indentation 

Single key insertion of “/* * and * */" 

Plus powerful position marking system etc. etc. 


NEW FEATURES of Ver 1.2 include: 
1. String search option to find strings in function 
definitions. 


2. Improved syntax checker warns of “=" used in 
condition context and other errors. 

3. Auto indent amount is now specifiable. 

4. C indenting now has closing brace feature. 

5. Automatic bracket matching. Ctrl-( jumps to a 
bracket the one at the caret - or 
signals an error if no match. 

6. Intelligent vertical alignment feature - Ctrl-Sh- 
Tab will put all your remarks in line at any 
column position etc. 


DeskEdit 1.2 costs €19.95 inc. VAT to members 


(upgrade: send original disc, SAE plus £2.00) 
See ad elsewhere for ordering details, 
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C Notebook 


Compiled and Linked by Lee Calcraft 


BEWARE OF resspr_init() 

].A.Wood and David Spencer 

If you are writing Desktop programs in C 
using RISC_OSLib, beware of using the 
function resspr_init(). The documentation on 
this function is far from clear, but it should 
only be used if you wish to load sprites into a 
user sprite area from an application sprites file 
named Sprites (or if you are about to load 
templates which makes use of such sprites). 


Once this new sprite area has been 
established, it is searched whenever icons are 
required for displaying windows and 
dialogue boxes. On RISC OS 2, the search 
begins and ends here, so if you are using 
resspr_init(), you must put copies of all the 
sprites that your application will need into the 
Sprites file (as does Paint for example). On 
RISC OS 3, the Wimp sprite pool is searched if 
the first search fails. 


WIMP VERSION 
Lee Calcraft 


With the advent of RISC OS 3 it may be 
important in some applications to know which 
version of the Wimp your task is running 
under. If you have ANSI C Release 4 you can 
make use of the new version of wimpt_init(). 
This now returns the version number of the 
Wimp - or more precisely, an integer equal to 
100 times the version number - so that Wimp 
3.00 returns 300, and so on. Note also that with 
the RISC OS 2 Window Manager the number 
returned is zero rather than 200. 


An associated new call documented in Release 
4, wimpt_wimpversion(), allows you to specify a 
version number above 200 if your application 
wishes to make use of features present in later 
versions. However, when testing this function, 
although my source compiled without 
warnings, it failed to link, issuing an Undefined 
symbol error for the function name. 


IS C FASTER THAN BASIC? 

P.S.Williams 

It has sometimes been said that compiled C is 
not very much faster than interpreted Basic on 
the Arc. To check this, 1 carried out some 
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comparisons, and found that in my test 
programs C won hands down every time. The 
first tests used loops of additions, 


multiplications and divisions, using integers, 
floats and doubles in C and integers and reals 
in Basic. 


int real int float double 
32 40 32 32 64 


add 95 116 2 #40 41 
mult 98 129 2. ‘IS “92 
div 115 162 8 97 158 


C and Basic timings - times in centisecs, 
sizes in bits 


To check these results in more realistic 
examples | also timed two other tasks. The first 
used integer arithmetic to calculate the number 
of ways to change a pound coin. Here Basic 
took 1 hour 35 mins, while C took just 41 secs! 


The second involved 10000 repetitive 
calculations on floating point numbers. Again, 
C came up fastest with 50 secs for double 
length calculations, 40 secs for single length 
floats, while Basic took 133 secs. 


If you want to check your change, or run any 
of the other tests, copies of the test programs 
appear on this month’s disc. 


HEX IN STRINGS 
Lee Calcraft 
When using embedded hex characters within 
strings passed to printf() and sprintf() certain 
ambiguities can arise. For example, take the 
following: 

sprintf£(test, "\x0éfaltering"); 
You might well expect this statement to place 
the hex character 0x06 into the character array 
test[], followed by the word faltering. Acorn’s 
ANSI C does not do this. It quite reasonably 
takes the ‘f’ to be a part of the hex value Ox06f. 
This is a lower case ‘o’, and the test string 
ends up containing the sequence: 


oaltering 


Please send us your C hints - all publi 
hints will be paid for. U 
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Exploiting the Wimp ———— 


by Mike Ironmonger 


T ransferring data between applications is 
an important feature of the RISC-OS 
Desktop. In Mastering the Wimp part 14 
(Volume 4 Issue 2), Lee Calcraft explained 
how to do this via the intermediate file 
<Wimp$Scrap>, and in this and the next 
article I'll be explaining how to transfer data 
directly via RAM. This is preferable because 
it is quicker, and does not require floppy 
users to have a particular disc present. 


SAVING DATA TO ANOTHER 
APPLICATION 

The first point to note about saving data 
directly to another application is that the 
first few steps are exactly the same as a 
normal save to the Filer. In fact no new code 
is required until after the DataSave message 
is sent to the destination task to inform it 
that a file has been dragged to it. The 
normal reply to this would be a 
DataSaveAck message quoting a filename 
under which the data would then be saved. 
However, if the destination task is an 
application that can cope with the RAM 
transfer protocols, it would reply instead 
with a RAMFetch message (see table 1) and 
one of two things would then happen. 


Ri+16 message action (6=RAMFetch) 
R1+20 pointer to destination buffer 


R1+24 length of the buffer 


Table !. Parameter block of RAMFetch message 


If the sender can’t transfer the data via 
RAM it simply ignores the RAMFetch 
message, and the destination task will revert 
to the <Wimp$Scrap> method of transfer. If 
the sender can transfer the data via RAM it 
recognises the RAMFetch message and 
starts the transfer immediately with the 
following steps: 


1. SYS “Wimp_TransferBlock” (see table 2) is 
called to copy the data into the 
destination task’s buffer. 
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2. A RAMTransmit message (see table 3) is 
sent to the destination task to tell it how 
many bytes were transferred into its buffer. 


handle of source task 
address of source buffer 
handle of destination task 


address of destination buffer 
number of bytes to transfer 


Table 2. Parameters for “SYS_WimpTransferBlock” 


R1+16 message action (7=RAMTransmit) 
R1+20 address of destination buffer 


R1+24 number of bytes transferred to 
the buffer 


Table 3. Parameter block of RAMTransmit message 


Depending on the size of the destination 
buffer, the transfer may or may not be able 
to take place in one go. If it can’t, the sender 
simply fills the destination buffer and the 
destination task will reply with another 
RAMFetch message. Steps 1 and 2 are then 
repeated, and this process continues until all 
the data has been transferred. 


TRANSFER DETAILS 

A real example of the above protocols is 
provided in the listing at the end of the 
article. This is a complete program that 
installs on the icon bar, and when you drag 
its icon to an application that can use the 
RAM transfer protocols, 100 bytes of data 
are transferred directly to the application. 
The data is simple text, so for the best 
results install Edit and drag the icon to an 
Edit window. To keep the program short, it 
can’t save to the Filer or transfer data via the 
<Wimp$Scrap> file, but you should be able 
to add the code described below to an 
existing application to achieve these things. 


PROGRAM DETAILS 

First note that whenever a RAMFetch 
message (number 6) is received, the 
procedure PROCram_fetch_received is called. 
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This is the heart of the transfer routine, and 
the first thing it needs to know is whether 
the RAMFetch message is the first one 
(replying to the DataSave message), or a 
later one (replying to a RAMTransmit 
message). There’s nothing in the message 
itself that indicates this, so the variable 
sending% is used, and if this has the value 
FALSE, line 630 calls PROCinitialise_sending. 


PROCinitialise_sending 

This procedure sets sending% to TRUE 
and assigns values to the variables 
destination_task%, source_buffer%, and 
bytes_left%. The first of these is self 
explanatory and is obtained from the 
RAMFetch message block. The last two are 
the address and size of the block of data 
that’s to be transferred, and they are both 
adjusted as each section of the block is sent. 


ive of whether PROCinitialise_sending 
was called, PROCram_fetch_received continues 
by obtaining the address of the destination 
buffer and the size of this buffer - both from 
the RAMFetch message block. Note that this 
is done every time the procedure is called, 
because if the transfer takes place in stages 
the destination task is under no obligation to 
use the same buffer at each stage. 


Next, lines 660 to 730 form an IF-THEN- 
ELSE construct which checks whether the 
destination buffer is large enough to transfer 
all the data at one go. If it isn’t, the transfer 
won't be the last, and the first section of the 
IF-THEN-ELSE is executed. This sets 
bytes_to_transfer% to the size of the 
destination buffer so that the buffer will be 
filled. It then assigns a value of 18 to the 
variable reason_code%. This will be used for 
the reason code of the RAMTransmit 
message, and it’s 18 (User_Message_Recorded) 
because a reply is expected - another 
RAMFetch message. If there’s no reply, the 
Wimp will return the RAMTransmit 
message to the program via reason code 19 
(User_Message_Acknowledge). This is 
picked up by line 200, which calls 
PROCram_transmit_not_acknowledged, which 
simply sets sending% to FALSE and reports a 
‘Data transfer aborted’ error. 


The second part of the IF-THEN-ELSE is 
executed for the last transfer. It sets 
bytes_to_transfer% to the number of bytes 
left, reason_code% to 17 (User_Message) 
because no reply is expected, and sets 
sending % to FALSE. 


Line 740 then calls SYS “Wimp_TransferBlock” 
to copy the data into the destination task’s 
buffer. The variables source_buffer% and 
bytes_left% are then adjusted appropriately, 
and finally a RAMTransmit message is 
created and sent. 


And that’s all there is to it. Next month I'll 
finish the series with a look at loading data from 
another application via RAM. 


REM > !RunImage 

REM Program Wimp Demo (Part 4) 
REM Version A 1.00 

REM Author M.C. Ironmonger 
REM RISC User March 1992 
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290 WHEN 26,64 : 
XE, YS) 

300 ENDCASE 

310 ENDPROC 

320 : 

330 DEF PROCdrag_done 

340 Bt=block$ 

350 SYS “Wimp_CetPointerInfo",, BS 

360 X$=BS!0:YS=BS!4 

370 windowt=B8!12:icon#=B$!16 

380 !B$=56:B$!12=0:B8!16=1 

390 BE!20=window$:BS!24=iconé 

400 BS!28=x$:88!32=¥$ 

410 BS!36=text_sizet:2%!40=4FFF 

420 $(B%+44) ="DemoText "+CKRSO 

430 SYS “Wimp_SendMessage”,17,blockt,w 
indowt, icon’ 

440 ENDPROC 

450 : 

460 DEF PROCreceive_message (messages) 

470 CASE message$ OF 

480 WHEN 0 : quit®=TRUE 

490 WHEN 6 : PROCram_fetch_received 

500 ENDCASE 

510 ENDPROC 

520 : 
530 DEF PROCcreate_drag_box (Xt, Y%) 
540 dlock$!4=5 
550 block&!8=X%-76: block’! 16=X%+76 
560 block#!12=¥%-52 :block$!20=Y%+52 
570 block$!24=0:block$!32=&7FFFFFFF 
580 block$!28=0:block$!36=&7FFFFFFF 
590 SYS “Wimp_DragBox”, ,block$ 
600 ENDPROC 


PROCcreate_Grag_box ( 


620 DEF PROCram_fetch_received 
630 IF NOT sending’ PROCinitialise_sen 


§40 Gestination_duffert=block$!20 
duffer_lengtht=block$!24 
IF bytes_leftt>=buffer_lengtht THE 


oy Oo 
oul 
Qo 


679 bytes_to_transfert=buffer_iengtht 

680 reason_codet=18 

690 ELSE 

700 byzes_co_transfert=bytes_lefts 

710 reason_codet=7 

726 sendingt=FALSE 

730 ENDIF 

749 SYS “Wimp_TransferBlock",my_task$, 
source _buffer?, destination_taskt, destina 
tion_buffer$, byses_to_transfer’ 
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750 source_buffert+=bytes_to_transfer® 
760 bytes_left%-=byctes_to_transfer’ 
770 block$!12=block$!& 
780 block$!16=7 
790 block$!20=destinat ion_buffer$ 
800 block$!24=bytes_to_transfer’ 
810 S¥S “Wimp_SendMessage”, reason_code 
$,block$,destination_task® 
820 ENDPROC 
830 : 
840 DEF PROCinitialise_sending 
850 sendingt=TRUE 
860 Gestination_task%=block$!4 
870 scource_buffert=text_block% 
880 bytes_leftt=rext_sizet 
890 ENDPROC 
900 : 
910 DEF PROCram_transmit_not_acknowled 
ged 
920 sending$=FALSE 
930 ERROR 1, "Data transfer aborted” 
$40 ENDPROC 
950: 
$60 DEF PROCerror(!blockt,$(blockt+4)) 
970 SYS “Wimp_ReportError’,blockt,1, °W 
inpDemo” 
980 ENDPROC 
990 : 
1000 DEF PROCinitialise 
1010 DIM block’ 999,menu% 123 
1020 SYS “Wimp_Initialise’,200,&4853415 
4,"WimpDemo” TO ,my_task® 
1030 quit%=FALSE 
1040 sendingt=FALSE 
1050 text_size$=100 
1060 DIM text_block® text_size%-1 
1070 FOR Bt=0 TO 390 STEP 10 
1080 ${text_block?+2%) ="Wimp-Demo”+CHRS 


1090 NEXT 


1110 Bt=block$: !BS=-1:B8!4=0:B8!12=144 
1120 BY!8=-16:8$!16=88:8$!20=1700610B 
1130 DIM BE!24 8:$(8%!24)="WimpDemo” 
1140 DIM BS!28 9:$(B%128)="sfile_fFE” 
1150 8$!32=9:SYS “Wimp _CreateIcon’,,Bt 
1160 : 

1170 M&=menut: SM="WimpDemo’ 

1180 M$!12=&70207 :M$116=96:M$120=44 
1190 ME!24=0:MB!28=&80:M$!32=-1 

1200 M$!36=&7000021:$ (M8+40)="Quit” 
1229 ENDPROC 


59 


(des 


> 


FOR 


: 
oc 
<= 
O 
co 


EXPANSION 


F A X 
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FaxPack is a fax expansion board for the 
Archimedes range of computers 
allowing your computer to take on the 
job ofa conventional fax machine but 
with the benefits of being fully 
integrated into the Archimedes. 


FaxPack offers full background send and 
receive capability. You can senda fax simply by 
selecting the PRINT option fromany RISC OS 
application, with control returned in justa few 
seconds. FaxPack then proceeds to dialand 
send the fax while you carry on using the 
computer. 


Receiving faxes is also completely automatic. 
FaxPack willanswer the phone and store the 
fax away on your disc while you continue to 
use the computer. Once received the fax can 
be viewed onscreen (using a special 
anti-aliased display to improve on-screen 
readability) and printed. Any portion of the fax 
image can be saved asa conventional sprite. 
Alternatively FaxPack can be made to 
automatically print on receipt of a fax, which 
witha LaserDirect printer, is completely 
automatic and in the background. 


moe ARCHIMEDES 


There are numerous advantages ofa 
computer based fax system overa 
conventional machine: 


Very high quality, pixel perfect faxes -try 
sending a fax of 8pt text from a conventional 
fax machine! 


Since there is no need to print, then re-scan 
a document, FaxPack saves time, paper and 
money when sending faxes. 


) Rather than junk fax mail wasting your 
costly fax paper, you can decide to delete 
unwanted fax files before printing. 


Q) By receiving and sending from the computer 
FaxPack offers a higher level of security than 
most conventional fax machines. 


L) FaxPack allows electronic archiving of fax 
messages and is one step towards the truly 
paperless office. 


L) FaxPack uses your standard Archimedes 
printer and so can print on plain paper rather 
than thermal paper. 


In addition FaxPack can be used asa data 
modem, to send and receive any Archimedes 
file or directory of files to other machines 
fitted with FaxPack. Because of the 9600 baud 
rate of fax systems and the use of data 
compression FaxPack is faster than practically 
all conventional data modems and permits 
background data transfer. 


FaxPack 
£299 + £10.00 carriage + VAT (£363.07) 


Computer Concepts Ltd 


Gaddesden Place, Hemel Hempstead, 
Herts, HP2 6EX. 
Tel: 0442 63933 Fax: 0442 231632 
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Please keep sending in all your hints and tips - don't 
forget, we pay for any we publish. 


FILE DRAGGING 
Matt Haris 


If you drag a selection of files onto an editor's 
icon (e.g. Paint, Draw, Edit), then each of the files 
in the selection will be loaded into the editor, into 
separate windows. This can be very handy if you 
need to load more than one file at a time and 
they are all in the same directory. 


FILE CLOSING 

Alan Wrigley 
From time to time, RISC User receives program 
contributions which make use of the statement 
CLOSE#0 to ensure that files are closed. This 
statement should never be used in a program in the 
Desktop, since it will close all files, including those 
which are being processed by other applications. If 
this happens, then the other applications will have 
a problem when they try to access their files. 


A problem which can arise is that files are 
sometimes left open when a program terminates 
with an error. Programs, particularly if they are 
multi-tasking, should always have an error handler, 
and this should contain commands to close any 
open files (by referring to them explicitly, not by 
using CLOSE#0 or similar) before the program 
terminates. In this way, such problems will be 
avoided, unless a Basic application ends with a 
fatal error (e.g. error type 0) in which case the error 
handler is not called and files can be left open - this 
is where *Close comes in handy. 


ADRL DIRECTIVE 

A.].W.van der Hoff 
In Hints and Tips (Volume 5 Issue 2) it was 
suggested that a literal could be used to contain 
any address which is beyond the range of the ADR 
directive. Whilst this is fine for code which is re- 
assembled on each invocation, the practice will 
provide invalid relocatable code, which is needed 
for instance in module code. A much safer and 
more general way of coping, with this problem is to 
generate the PC-relative instruction in two steps, 
with each one using an acceptable immediate 
constant. This will provide a byte address range of 
64K, which should be adequate in most programs. 


Acorn’s assemblers (but not the Basic assembler) 
provide an additional directive, ADRL, to 
produce two instructions along these lines, and 
we can use Basic’s macro facility to emulate this: 
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DEF FNfarADR(Rt,A%,opt$) 
IF A%>P$ THEN 
[OPT opts 
ADD R$, PC, 4 (A$-PS-8)MODE100 
ADD R$, RE, # (AS-PS-8) DIVE100<<8 
] 
ELSE 
[OPT opt$ 
SUB R%, PC, #(P$-8-AE) MODE100 
SUB R%,R%, #(P$+8-Ab) DIVE100<<8 
] 
ENDIF 
=optt 
Now, where a program requires to load a register 
Rn with an address code within a 64K range, just 
call the function as follows: 
. code 


. label : FNfarADR (Rn, code, opt $) 


where opt% is the current value of the assembler 
directive OPT. The label /abel is optional, but if it 
is there the colon before FNfarADR must be 
present to associate the label with the address of 
the farADR instruction. The macro will always 
generate a 2 instruction sequence, essential for 
the general case, so if you're really concerned 
about code length or the odd nanosecond at run 
time, then only use this when ADR has failed. 


FILE AND DIRECTORY ACCESS QUIRK 
Mike Whiteman 


Suppose you make a selection of files in a 
directory viewer and then change the access 
attributes via the Selection submenu, If the first 
object in the selection is a file, then only files in 
the selection will have their access changed. 
Furthermore, if the first object is a directory, then 
only directories in the selection will be changed. 
The best way to access all the objects is to Select 
All and change access, and then to Select All 
again, but deselect the first few objects that are 
all of the same type. 


DR DOS CURES MS-DOS 
RG.Sharman : 


If you couldn't wait for Acorn to bring out their 
upgrade for the PC Emulator under DR DOS and 
shelled out for the MS-DOS version, you will find 
that the MS-DOS version doesn’t come with a 
manual - however the DR DOS manual will 
provide almost all the help you need. Furthermore 
the only editor that comes with MS-DOS is the 
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single-line EDLIN, but the EDITOR.EXE editor 
from DR DOS works perfectly under MS-DOS so 
it is worth copying it across. Also the MS-DOS 
ATTRIB command won’t support ‘system’ 
attribute control, whereas the DR DOS ATTRIB 
command does - if you use the DR DOS version 
instead (the file called ATTRIB.EXE), you can have 
control over ‘system’ attributes in MS-DOS (using 
the syntax given in the DR DOS manual). 


PROMOTING IMPRESSION JUNIOR 
K.]. Bracey 

If you use Impression Junior, then it is possible to 
access some of the text handling features which 
only Impression 2 is supposed to have. If you 
export a text story into Edit with the “With 
Effects” switch on, you will see commands 
enclosed in curly brackets at the start defining the 
basic style and the rulers, and within the text to 
denote effects (such as {font Trinity.Bold} and 
{pagenumber 0}. By altering or adding commands 
and importing the text back into Impression 
Junior, you can access some of Impression 2's 
features. For example to insert a decimal tab into a 
ruler three inches from the left margin, insert 
decimal 216pt into the list of tab positions. This tab 
cah then be slid up and down the ruler in 
Impression Junior as normal. Most of the other 
things you can do can be found by trial and error, 
but Computer Concepts will send you full details 
of this DDF (Document Description File) format if 
you write to their Technical Department. 


ADJUST SCROLLING 

Peter Sowerby 
Don’t forget that clicking on a window’s scroll 
arrow with Adjust scrolls the window in the 
opposite direction to the arrow (i.e. clicking with 
Adjust on one arrow is the same as clicking on the 
other arrow with Select). This also applies to 
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clicking in the dark grey part of the scroll bar (which 
is equivalent to a Page Up/Down action) - with 
Select the scroll bar moves towards the pointer, and 
with Adjust it moves away from the pointer. This is 
invaluable when trying to display the very end or 
very beginning of a window that doesn’t support 
keyboard movement. 


COMMAND ABBREVIATIONS 
Mike Williams 


When using the CLI you can abbreviate 
commands by terminating them with a full stop. 
However RISC OS 3 has a large number of new 
commands, so some command abbreviations are 
no longer refer to the same commands they did 
in RISC OS 2 (e.g. in RISC OS 2 *Cha. means 
*ChannelVoice, but it means *ChangeDy 
namicArea in RISC OS 3). The best way to avoid 
a clash is to use the full commands in your 
programs, though of course abbreviations are a 
quick and handy shortcut if you are using F12 
from the Desktop. 


PALETTE ERROR 
Kell Gatherer 


There is a "mistake" in the RISC OS ROM! The 
sprite for the Palette utility is imperfect. It can be 
examined by using the Magnifier application and 
having a close look at the Palette icon on the icon 
bar. You may have to adjust the contrast on your 
monitor to see what's wrong: look at colour 6 (the 
grey above the green). Alternatively save the 
ROM sprites to disc by entering the following 
from Basic: 

SYS*Wimp_BaseOfSprites® TO romt 
SYS*Sprite_Op", 268, rom%, *ROMSprites* 
which will save the resident ROM sprites to a file 
ROMSprites in the currently selected directory, 
from where they can be loaded into Paint and 
examined. f 


* POINTS ARISING « POINTS ARISING + POINTS ARISING ° 


CONTROL CODE INSERTION UTILITY 
FOR EDIT (Volume 5 Issue 2) 


An error crept into line 300 of the !RunImage 


listing. The correct line is as follows: 


300 WHEN 2:SYS “Wimp_CreateMenu", ,menu®, 


tbk#-64,140 


A DESKTOP PLAYER FOR MAESTRO 
FILES (Volume 5 Issue 3) 


The listing given is correct if you are modifying 
the original program from the Volume 1 Issue 9 
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magazine. However, if you are modifying the 
program of that month’s magazine disc, ignore 
the instructions given in the article - simply 
delete lines 65, 91 and 92 and add the given 
listing. 


EXPLOITING THE WIMP (PART 3) 
(Volume 5 Issue 3) 
A line was missed off the end of the listing 
given. It should be: 

1490 ENDPROC AU 
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PIPEDREAM’ 


Imagine a flexible word processor in 
which you can use fonts and pictures to 
give stunning presentation to your 
letters and reports. And a 93,000 word 
spelling checker and user dictionaries 
for letterperfect writing. 

Imagine the most powerful spread- 
sheet package on the Archimedes. 
Background recalculation so you carry 
on working while it computes. 160 
built-in funcnons, plus a programming 
language for your own custom fune- 
ons. Arrays within slots for casy 
mampulation of structured dara 

Imagine dynamic charts straight from 
your data. Multiple scales to compare 
trends, Personalised Penguin Graphics 
with bars filled by your own draw files to 
dazzle vour friends and colleagues, 


COLTON software 


Colttonsoft Limited 


qnet Court 


Swanns Road 
Cambridge 

C85 SLA 

Tet: (0223) 311881 
Fax: (0223) 312010 


Imagine a fast and compact database 
package with full sorting, searching and 
selection criteria. With links straight to 
the word processor for printing mail- 
shots and labels. 

Imagine user-friendly fearures such as 
configurable menus, template files cto 
start new documents from, and auto- 
matic fitting of column widths to the 


data, 


PipeDream 4 
the works 


Free vour imagination 


RRP £196+VAT. Call for cducation prices 
and site licences. PipeDream 4 0s ideal for any 
Archimedes, A3000 or ASOOO with 2MB 
RAM or more 


Fora free £8 brochure. complete und 
return this coupon 
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ALLOCATING MEMORY FOR 
DOCUMENT FILES 


Dear Sir 
1am writing a Basic program which needs to 
load and process large documents. What is 
the best way of allocating sufficient memory 
to handle these files? 
TJ. Dickson 

_ There are a number of ways to do this. Firstly, if at 
the time of writing the program you know the 
maximum length of the file you will be processing, 
you can dimension a block of memory at the start 
of the program (having made sure the WimpSlot is 
large enough), with a statement such as: 

DiM memblk? 4096 
If you are only processing, one file each time you 
run the program, you can use this method even if 
you don’t know the length of the file. To do this 
you must first call OS_File to find its length, and 
you can then dimension the block and load in the 
file, for example: 

S¥S *OS_File",17,file$ TO «,,,lent 

DIM memblx% lent 

SYS "OS_File",255,fileS, membikt, 0 
where file$ holds the full pathname of the file. If 
your processing of the file is likely to increase its 
length you must of course take this into account 
when dimensioning the block. 


This method is not suitable, however, if you may 
be processing several files one after the other and 
you do not know the maximum file length. You 
would need to dimension a block for each file, and 
since the earlier blocks cannot be re-used you 
would soon run out of memory. For these 
situations there are much better methods. 


Firstly, Basic has a keyword END which, among 
other uses, can be used to allocate extra memory 
to the program. Unfortunately, under RISC OS 2 
this cannot be used within procedures, functions 
or loops, and so it is of little practical value in the 
circumstances we are considering here, unless 
you have RISC OS 3. 


A better method is to request a private block of 


where size% is the required size of the block, and 
memblk% is returned as the start of the block. 
Notice that the X form of the SWI has been used 
and any resulting error trapped, since if the claim 
is unsuccessful you will get an error if you 
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subsequently try to access the block. You should 
also free the memory after you have finished 
with it, using: 
SYS "OS _Module",7, ,memblk% 

The problem with this method is that although the 
memory is de-allocated from your task, it remains 
in the RMA, This means that if other applications 
or modules claim RMA workspace and your 
chunk is too small to be re-used, the RMA can end 
up like a Swiss cheese peppered with “holes” 
which are wasting memory. 


By far the best solution is to use the SWI 
Wimp_SlotSize to claim additional memory. This 
is the way applications such as Edit allocate space 
for a document. Where Basic is concerned, this 
does the same job as END but can be used 
anywhere in the program, Provided there is 
enough spare memory available, the call can be 
used to alter the size of the current slot. RISC OS 
maps the extra memory in such a way that to the 
application it appears to start at the top of the 
existing slot - in other words at the address held in 
HIMEM for a Basic program, Note that HIMEM 
does not change after the call, however, so Basic 
itself is totally unaware of the extra memory. 


To use the call you must first find the size of the 
current slot. In Basic, a simple way to calculate this 
is to deduct &8000 from HIMEM (because all 
applications start at &8000) - provided of course 
that no previous alteration has been made to the 
slot size, since HIMEM will then be inaccurate. For 
non-Basic programs, the same information can be 
found by reading the OS variable MemoryLimit, 
but this is outside the scope of this article. Once 
the current size is found, you can then add to it the 
required extra memory and call Wimp_SlotSize, as 
in the following example: 


memb1k&=HIMEM: size$=HI 


ror 
REM load document at memblk% 
REM process document 

SYS "Wimp_SlotSize*,size%,-1 
where /en% is the length of the file determined by 
using OS_File as described above. 


You can now load the file at memblk% and 
process it exactly as if you had dimensioned the 
block using DIM. When you have finished, the 
second call to Wimp_SlotSize restores the original 
slot size. Note that, as before, the condition in 
which the memory is not allocated is trapped, in 
this case by comparing the size of the new slot 
with that of the old. 


Alan Wrigley JU 
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As the leaders in software for the Archimedes range of computers, CLARES 
MICRO SUPPLIES are looking to extend our range even further. We are 
looking for people who are as excited by the Archimedes as we are. 


If you have written any programs, completed or not, then we would like 
to hear from you. 


If you have any ideas for programs and have the ability to execute the 
ideas then we want to hear from you. 


lf you have the ability to program the Archimedes but not the ideas to 
program then we want to hear from you. 


Programs can be written in any language as long as they perform their 
stated task. Many of our programs contain large chunks of BASIC with 
ARM code in the areas that it is needed. BASIC on the Archimedes is a 

very powerful language and we do not attach any snob value fo its use. If 
your program does what is meant to do then thats all we are interested in. 

Why not join the top team on the Archimedes. You get the support of our 
in-house team, privileged access through us to Acorn and invitations to 

our informal programmers seminars. 


The most important point is that you will be earning top royalty rates of if 
you prefer we will purchase your program outright. 


Please write, in confidence, to Mr. D, Clare at: 


Clares Micro Supplies, 
98 Middlewich Road, 
Northwich, 
CHESHIRE CW9 7DA 


lf you have a program either complete or in development then please 
enclose a copy for our evaluation. 


To protect yourself we advise that you lodge a copy of the program with 
your bank or solicitor BEFORE you send us a copy. You can then prove 
that your program pre-dates anything that we have. 


Act today and become part of the leading software team producing 
software for the worlds fastest micro. 


RISC User Public Domain Library 


Our Public Domain discs contain as near as possible to 800k (and not less than 700k).Each disc includes a ‘Read Me’ file, 


and there are some instructions with the 


programs The dises are offered as seen and are available to RISC User members only 


for £3 ( 1s £1 for the first disc and fe h a I disc). To order 0727 , Fax 0727 
aed: ene 50p for cach additional disc). To phone 40303, Pax 860263. 


uoting your membership number) to: RISC 


DEMOS 
PD12 Dise 5 sound and graphics demos from 
Hugo Fiennes of the Serial Port, All 5 are 
stunning exaniples of what the Are is capable, 
PD 21 Dise 4 demos, Balls, Bally2 and BLA- 
Tetris, The later is. a pane as well asa demo. 
PD22 Dise 4 demos, Noah, Chips and Dermot 
PD 23 Dise 4 demos, Bounce, Crimbo, 
ColDeme and Rote 
PD24 Dise 4 demos, Demo, Gopher and 
Overscan. 
PD25 Dise 4 demos, Deskbails, DudsDemo, 
Egintro, and Z-Bmther 
PD 26 Disc 4 deren, iter, SkullDerp and Wiktie. 
PD27 Dise 2. demos, GranyChow and Windows 
PD36 Disc 3 demos, Leapin’ Fish, SinDeimo 
and Swallow 
PD37 Disc A massive four-pant demo called 
“No RISC No Fun’. This has to be the best dero 
yet forthe Arc. Amazing! 
PD42 Dise 4 demos, AceDemod, Cubitus, 
Scorpius and 3D_RayPic. 


GRAPHICS 
PD 13 Dise The 'Projector application - 
displays films created with the Ace Computing 
Mogul package. Six example films are included 
PD18 Disc 4 program which displays several 
stal and animated ray traced pictures. 
PD33 Dise Comains 3 that displays 
several sill and animated my traced pictures. 
PD44 Disc A selection of fractal generation 
programs and utilities. 
PD45 Disc Z applications, Creator and 
Translator, allowing exchange and displry of 
graphics picture files between Archimedes and 
other computers, Also some high quality demo 
pictures as a mode convener anda mode 
utility allowing multisyne modes to be 
displayed on a non-multisyne monitor. 


DRAWING AND ART 


PD15 Dise Arctisi+ and BigM, both 256 colour 
art packages, along with Design, a symmetrical 
pattern designer. 
PD41 Dise 4 sercstioos ‘Display’ allows the 
display of Draw files by dragging them into a 
window “Drwplus’ is an object oriented 
drawing package that may be used as an 
alternative to Acotn’s Draw supplied with your 
Archanedes or A000. Drawplus has many 
enhancements over Draw. ‘Draw “isa 
rogram 10 enable the easy creation of function 
eystrips using Draw: ‘Drop! enables Draw files 
10 be rotated in 3D and then saved again in 
their new perspective 


EDUCATION 
PD 14 Dise ‘REG, a student register sysiem 
which replaces classroom registers. A system 
for managing the recording and reponing 
required by the National Curriculum and data 
tiles for Pipedream for NC statements of 
allainment jn science 


MUSIC 
PDO1 Disc Sounckrcker playroutine plus the 
following tunes: Aces-Hi, Ac 2. Aft, All, 
AnNowe. AxelF Backpopped, Big, Bitzwing. 
Blizzard02 


PDO2 Disc Soundiracker playroutine plus the 
following tunes: BatMix, Bobby, Brill, Burning, 
Chanmix, Chipgene, Demo2 

PDO3 Dise Soundiracker playroutine plus the 
following tunes; Confusion, Crick, Criminal, 
Dear, Demons, Dns, Elephant 

PDO4 Dise soundiracker playroutine plus the 
following tunes: Decl, Funky, Due 

Electric_2, EndTheme, Enutomed, Equinoxes, 
Fini TFDMI, FinalVis 

PDOS Disc Soundinicker playroutine plus the 
following tunes: Pye Coodfane Hello, 

How s, Huta, Humanok!, Hunters, 
Hymn, Idea, Igarun, intoB. 

PDOG Dise Soundincker playroutine plus 
these tunes: Jazzid, Jm|_China, Last Ninja2, Like, 
Magnetic’, MegaForee’, Minimize, Mod, New_Biz 
PDO7 Disc Soundtracker playroutine plus 
these tunes: MyWay, Nothing-2, Oooer, Outrun, 
Pacman, Pat, PeShop, Pretend, SaySaySay2, Seeve 
PD 16 Dise 23) tunes for loading into the music 
Package Maestro, variety enough to suil most tastes. 
PDOB Dise Soundiracker playroutine plus 
these tunes: Setrox, Tarzan, TOM, TheModel2. 
TiatMikes, Toccata, Unit, Vprtex, We're, Yezz. 
PDO Dise Sounckracker playroutine plus the: 
tunes: Acid_House, Bananas, Carobod, Crok, 
Cute, Dallas, Deadlock, Dragnet, Yazun. 

PD10 Disc Soundiracker playroutine plus the 
following tunes: DemoSmash, FPSound, Five, 
GSCTheme, HiEnergy, Oxygene2, Piano, 
PopCarm, Pupp. 

PD 11 Dise Soundiracker plsyroutine plus the 
following lunes, Rescue, Rockit, Round Scratch, 
Seratch2, Show, StackeOn 

PD40 Dise The Jukebox playroutine plus the 
following Tracker tunes; Acid House, 
TeddyBears, Canon, Breathe, Six2, Rag It 
PD43 Dise An application called Coconiser. 
very sitnilar to Tracker, Uiat allows the creation 
of tunes by sequencing digitally sampled 
sounds Demo tunes are included on the disc. 
PD46 Dise The Jukebox pluyroutine plus the 
following Tracker tunes: Beginning, Blue Peter. 
Frog Song, IeeleeBaby, Monty Mix, Over The 
Bow, Rawhide, SkyXmasMix, Thunderbird 
PD47 Disc A selection of SoundTracker and 
Tracker playback routines and utilities including 
a keyboard and spectrurs analyser 


SAMPLER DISC (PDS1) 
Contains the 


TRICKS AND NOVELTIES 
PD17 Dise A collection of 27 amusing novelty 
programs. Some produce the weirdest effects’ 
PD32 Dise Contains an application culled 
Cookie. When cun. it puts up a window 
containing a ‘fortune cookie’ of a well-known 
saving or piece of philosophy Be warned! Very 
addictive once seen, also rather zany not to 
mention, occasionally saucy! There are some 
6000 sayings. Also on this disc is a scroll text 
demo with sounckrack nmsi¢ called Invade that 
also features a space invaders game within it. 
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UTILITIES AND APPLICATIONS 
PD28 Dise 20 utilities of various types. There 
is something here to please everyone, Space 
does not permit full deseriptions but the file list 
is, Istile, ASm2, CloseUp, Crypt, Dir, Display, 
Drawtink, Dustin, Filetypes, FileLtils, Find, 
Keys, ra ay MultiPrint, NewBar, NewCodes, 
PD _Impress, PrinterTx, ProgCale, and Set_Type. 
PD31 Disc 17 utilities and applications. Pleny 
on this disc to choose from and should find 
favour with most people. Brief description of 
the list is as follows: Address Book, Address 
Labelles, vs eo Desktop Calendar, 
Cassette Inlay Printer (Two of these!), DFS Disc 
Reader, Automatic Application Creator, Arc to 
Psion Transfer, ROM $ 5 - sTD 
Codefinder, System Utilities, Trash Can, Front 
end for Twin, Front end for View, Volume 
Controller, Control of Pointer by keys, 

PD38 Dise 15 utilities and applications. These 
are a Ist Word Plus file converter, a lst Word 
Plus printer driver for Star LC 200, a text outliner 
“pplication, a hypertext program (like Genesis), 
a CD database, a video tape datibase, CMOS 
RAM saver and loader, disc sector editor, fast 
formatter, font printer, file save reminder, a 
COPY options setter, and TEXT to DTPfile 
converters, plus a print spooler. 


CLIPART AND PICTURES 
PD29 Dise Over 4 megabytes of Spite pictures 
which can be used as clip an to load io DTP ce 
use in your ims. The files are naturally in a 
coupressed form and the disc contains the file to 
uncompress them plus instructions. 

PD30 Dise Over 2 megabytes of Sprite clip an 
and Draw files to load into DTP or use in your 
programs. The files wre naturally ina 

form and the disc contains the file 
to uncompress them together with instructions 


FONTS 
PD3S Dise Eleven PD outline fonts fer use in 
RISC OS applications such as WP and DTP. 
These are, Stencil, American Typewriter, 
Bodoni, Brushscript, Cooper Black, Fritz Quad, 
Garamond, Hull, London, Optima and Revue. 


COMMS 
PD34 Dise Arcterm’, a full comms software 
package. Arcl00, a scrolling text terminal. 
Grapevine, another scrolling text terminal bat 
multitasking TaskDats. a multitasking viewdata 
comms package. Download, an application for 
transferring files between machines via serial 
port Timer, a utility for recording on-line time 
and call cost, The latest version of Sparkplug, the 
file decompression program, Also a complete set 
of programs for running a bulletin board system 
on your Archimedes, 


GAMES 
PD 19 Dise 10 games; Adevnture, Battle, 
Battleships, Conneet4, Darts, Fish (Pelmanism), 
Fruit Machine, Golf, Hangman and Impact. 
PD20 Dise 12 games: Invaders, Line Of Five, 
Othello, Pelmanism, Rocks, Rubik Cube, Simon, 
Solitaire. Star Trek, Tecris, Tile Trial and Yahtzee. 
PD39 Dise 6 games: Pac Man (in a window’). 
Arc Patience, Breakout (inske an con't), 
Creepie (Cemipede), Pelmanism and 
International Golf (Brilliant’) 
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PROGRAMMING WITH A SENSE OF 
HUMOUR 


Members may be aware that serious programmers 
occasionally show a dry sense of humour, and this 
is manifest in the OSCLI command of Basic V 
which is described on page 237 of the BBC Basic 
Guide for the Archimedes. 


Under some circumstances, information is passed 
through some of the processor's registers, in a 
manner similar to that used with CALL. In the case 
of OSCLI, R1 contain &BA51Cxxx where ‘xxx’ is 
a specific value for the version of Basic (‘005' in the 
case of Basic V). 

Richard Grant 


Weil, it took a few seconds for the penny to 
drop with us - if you can't work it out yourself, 
we'll include a brief ‘solution’ next time around. 


UPGRADING TO AN A5000 


I have been a regular subscriber to RISC User for 
about a year now, and have purchased all available 
back copies. I find your magazine to be the best 
available on the Archimedes range of computers, 
and I’m sure I have obtained more information 
about the workings of these machines than all the 
others I read. 


1 read with great interest your articles on the new 
A5000 and RISC OS 3. Although it is early days, 
your articles did leave a couple of questions 
unanswered. Is the A5000 able to accept the 
connection of a 5.25” floppy disc drive? If yes, does 
it require the purchase of an additional interface as 
with the A3000. 


Is RISC OS 3 backward software compatible? 
Should existing software like Ovation, Impression, 
ArcDFS, Instigator etc. still function correctly 
under RISC OS 3? 

David Symes 


To answer your questions, the A5000 will 
accept 5.25” drives. but you will need to 
purchase an interface specifically for the A5S000 
to achieve this. RISC Developments is currently 
developing such a device, and this should be 
available very soon 
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Most software already available will run under 
RISC OS 3 without any problems. In some cases 
some minor alterations are needed, but most 
software houses will update their software and 
provide an ASOOO compatible version free of 
charge on request. it may be worth checking 
the situation on specific software before you 
make the change though. 


CAUTIONARY TALE 

My hard disc failed recently so | purchased a 40 
MB drive from a company which shall remain 
nameless. | went for the cheapest option, an ST506 
unit. | thought the drive was new, but once 
installed | found it had about 20 MB of files on it 
from the previous owner. Many of these files were 
useful - I got several new fonts and a couple of 
megabytes of clipart, amongst others. 


However, it didn’t take long to find the name of the 
previous owner, from correspondence on disc with 
his bank manager, building society, friends in 
Australia, etc. The moral is clear: if you are selling 
a computer, make sure you get rid of everything 
you consider private! 

Kell Gatherer 


And merely ‘deleting’ files is insufficient - that 
only removes entries from the directory 
catalogue. You are recommended to reformat 
the disc for complete security. 


BEWARE THE OVERLOADED ARC 


T recently purchased a certain game for my 
upgraded Archimedes 310, but the game kept on 
crashing my computer. 1 am about to send it back, 
but I believe | know why. 


The operating system call: 

SYS *OS_UpdateMEMC”, 64,64 

instructs the Arc to access ROM at RAM speed, 
and can (theoretically) speed up a program by 
about 20%. However, this call requires ROM chips 
to perform beyond their stated specification; while 
the majority do, not all ROM chips produced for 
the Arc can operate at the increased speed. 


So, all professional Archimedes programmers: 
PLEASE do not use this operating system call in 
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commercial software, unless it can be revoked by 
way of an option or configuration file. 
Kevin Gomm 


Useful advice indeed - however, if you try this 
call out on your own machine (in immediate 
mode in Basic, say) and it causes no probiems, 
it could be worthwhile including it in your 
normal boot sequence to take advantage of the 
increased speed which is then possible. 


FORTRAN FRIENDS 
I see that people are still wondering why there is so 
little scientific software for the Archimedes. 


As a practising scientist I have been writing 
Fortran programs for many years. | have Acorn 
Fortran77 for my Archimedes, but Acorn show 
little signs of updating Fortran, as they have C and 
Assembler, so | am trying to form a self-help group, 
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which | call ‘Fortran Friends’. | maintain a list of 
known errors in the compiler, and I have made a 
Fortran Desktop front-end and a set of assembler 
subroutine libraries for use with Fortran77. These 
are ‘graphics’, ‘SpriteOps’ and ‘utilities’, with a 
‘Wimp’ library in preparation. 


Now I am looking for others who may know of 
further Fortran errors or who have additional 
routines they would like to contribute to a public 
domain set of Fortran Tools, particularly any 
numerical algorithms to which they hold the 
copyright. If there are enough routines, we should 
ask some software dealer to carry out the 
distribution of both software and documentation. 
Kate Crennell 


We will be happy to act as a clearing house in 
this endeavour, if letters are sent to Kate c/o 
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Taxan KP810 printer, NLQ, downloadable fonts £60, 
Schema £40, Fest Word Plus release 2 £30, interword WP 
for Archimedes £10, PC Emulator with MS-DOS £20, all 
original software with manuals. Tel. (08444) 4633 
dayleves, 


Acorn Cambridge Scientific workstation, BBCB & 
NS3200, 4Mb RAM, hard disc drive, single disc drive, 
streamer, KXP1081 printer, Fortran, C, Lisp, ISO Pascal, 
Basic, full manuals, offers/part exchange. Tel. 021-711 
228 anytime. 

788, rechargeable batteries, charger, 32k RAM pack, 288 
to Are. leads, 2B8 to Arc. software and leatherette carry 
case - a5 new £150 the lot. Tel (0926) 421332 

Brand new Acorn Multisync monitor from AS000 
Learning Curve £170, 288 portable computer 12 months 
id boxed with manuals £70, Atomwade VIOC Enhancer 
and mode designer, latest verson 1.60 £18, HCCS A3000 
¥O £20. Tel. (0782) 771914 of 412515 extn. 4034 


Scanlight Junior scanner for A3000 complete with 
interface card, power supply, manuals and updated 
software disc, (selling due to not being suitable for new 
ASO00) in excellent condition £140, Tel, (0533) 570542. 


43000 2Mb, Philips CM8833 colour monitor includes 
Serial Port upgrade and monitor stand £650, also Star 
L.C24-200 colour printer £185, Tel, (0865) 864182 


Brother HR-15 daisywheel printer with 3 wheels & 
ribbons, boxed £200, Graphbox £35, Inteword £15, 
Intersheet I £15, Spelmaster £25, al original on disc for 
Arc. Tel 081-989 2666. 


S40 4Mb RAM, 120Mb HO (2000, Taran 795 Moyne 
monitor £200, A3000 MidiUser port £30, A3000 carry 
case £20, unused WD362 20Mb STSO6, internal 35° 
dive £70, WO Caviar 140 40Mb IDE interna sinine 35° 
ive £90, Linet external V21/23 made with cable £50, 
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boxed Citizen 1200+ printer with cable & ribbon £90, 
boned intenword ROM £15, Acorn Lisp £15, Informix AGL 
discs £70, new Cumana extemal 3.5* drive & interface 
£110. Write to; Mr G Bailey, 9 Kingcup Drive, Bisley, 
Surrey GU24 SHH 


Camcorder and Hawk V9 digitiser, Flevtile, Tracer. Tel 
(0366) 501001 for detaits, 


Pace Linnet V21/23 modem & Hearsay £ 100, Star \C- 
10 Multi-Font NO printer £90, Ist Word Pus release 2, 
Geness, PC Emulator V1.34 £25 each, Saloon Cars, Break 
147, Repton 3, Pipemania, Nevyon, inertia £12 each. Al 
originals. Tl. (07683) 52268. 


Arc. 410/1 SOMb hard disc and 4Mb RAM, Acorn 
colour monitor, L550 Epson printer and manuals £1300. 
Tel 091-252 4816 eves. 
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Soap Powders - Monthly Sales 


Line graphs can plot just points, points joined by fines or fines 
only. Line graphs provide three variants, simple line graphs, 
layered line graphs and cumulative layered line graphs. 


A sophisticated multi-tasking package for the 
Archimedes 


ChartWell has particular strengths when pie charts are 
needed. Up to six pies can be included in a single 
display with the total area of each pie showing the 
relative total values. Pie charts can be 2D or 3D with a 


wide choice of other options. 

Vertical and horizontal bar charts in Experimental Data 

six different varieties giving a total of 

12 different styles. 

Monthly Sales 

Polar graphs can be plotted from lage Tine (minteed 
mathematical polar equations or sper — aes 
from data supplied by the user. In periment ata can be p a 
the latter case up to six data sets choice of fines of best fit selected 
can be plotted on the same polar Equations and regression co-efficients 
graph. are displayed for reference. 


Chartwell is supplied with Outline Font Manager and Swiss-B outline font, a full reference manual with a tutorial section. The disc includes 
demonstration data and graph files. Members’ price £24.95 +p&p. Code PCHWb. 
RISC Developments Ltd. 117 Hatfield Rd, St.Albans, Herts AL1 4JS Tel. 072750303 Fax 0727 880263 


RISC USER MEMBERSHIP 


RISC User is available only on subscription at the rates shown below. Full subscribers to RISC User 
may also take out a reduced rate subscription to BEEBUG (the magazine for the BBC micro and 


Master series). 
Renewal Subscription Rates RISC User RISC User & BEEBUG 
UK, BFPO, Ch./s £18.40 £28.90 
Rest of Europe &Eire £27.50 £42.90 
Middle East £33.50 £53.10 
Americas & Africa £36.50 £58.40 
Elsewhere £39.50 £62.50 


Please note that new subscription rates are £1.50 more than renewals. 
All subscriptions, including overseas, should be in pounds sterling. We will also accept payment by 
Connect Access and Visa, and official UK orders are welcome. 


MAGAZINE DISC 


The programs from each issue of RISC User, together with a number of substantial additional items, 
are included on a monthly 3.5” disc. This is available to order, or you may take out a subscription to 
ensure that the disc arrives at the same time as the magazine. 


Disc Subscription Rates UK Overseas 
Single issue discs £475 £475 
Six months subscription £25.50 £30.00 
Twelve months subscription £50.00 £56.00 


Disc subscriptions include postage, but you should add the appropriate rate (see below) per disc for 
individual orders. 


BACK ISSUES (SPECIAL OFFER) 


Back issues of magazines and magazine discs are normally available. All issues are currently still in 
stock except Volume 1 Issues 485 magazines, All subject to availability. Please include postage when 


ordering. 
‘ Volume 7 Volume 2 Volume 3 Volume 4 
Magazine £1.00 eath £1.20 each £1.60 each £1.90 each 
£2.00 each £4.00 eath £4.00 each £4.75 each 
Post and Packing UK, BFPO, Ch.Js furope plus Eire Elsewhere 
First issue £1.00 £1.60 £2.40 
fach subsequent Issue £0.50 £0.80 £1.20 


RISC User & BEEBUG, 117 Hatfield Road, St Albans, Herts AL1 4S. 
Tel. St Albans (0727) 40303 Fax. (0727) 860263 
(24hrs answerphone for ConnectiAccess/Visa orders and subscriptions) 
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THE COMPLETE TEXT EFFECTS PACKAGE 


TypeStudio allows outline fonts to be manipulated to produce high quality adverts, posters, 

banners, logos, letterheads etc. - the possibilities are endless. Text may be flowed along 

straight or curved paths, or moulded to almost any shape. A wide range of interesting 

effects may be then be applied to enhance the design further. You can use all 

"Sry. these effects on Draw files too! With integrated drawing tools, grid and 
r zoom facilities and a range of outline fonts, TypeStudio really is 

the complete solution to producing superb text effects. 


qqpesTuolo TYPESTUDIo oe 


+ Text flow along straight & curved paths » Mould text to any shape 
+ Wall, floor & graduated shadows ¢ Copy, rotate & magnify 
+ Mould Draw files to any shape « Grid and zoom facilities 


"ey, + Import Draw files * Print using RISC OS drivers 
2, ZN * 3D effects « Plinth effects + Mirror effects 
“~D Pa, * Tools for drawing straight & curved lines 
ve; gZ %, + Save in internal & Draw file format 
"OQ Qn 
S 
Op, ee e, Site licence price: £75 + VAT 


v4 ‘e ys Single user price: £45 + VAT 
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117 Hatfield Road, St. Albans, Herts. AL1 4JS 
Tel: (0727) 40303 Fax: (0727) 860263 


